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The NOS/VE Rl.1.2 level 630 Software- Rel ease Bulletin CSR8) is to be 
used with the NOS/VE Installation and Upgrade Hanual {Publication 
6.04639131 for installing NOS/VE and its software products* Control Data 
recommends that the SRB be read in Its entirety prior to software 
inst ai I ati on* 

The SRB is the vehicle used to document any changes to the Installation 

and Upgrade Manual after it has gone to print. The SRB also documents a 

number of system deficiencies* It is necessary to install NOS 2*4.1 

Level 630 or N0S/8E 1.5 I eye I bll * Level 526 of the Common Products* and 
CIP 003 before installing NOS/VE- 31.1*2. 

The following warnings and restrictions are especially important to this 
release? 

1. A Backup_Permanent_FHe operation must be done using the old 
system before upgrading to Rl.1.2 and the files restored using 
level Rl.1.2* See Section 3.1*2 for more information* 

2. As of release 1.1.2* permanent file labels will fee written in a 
new format which older systems will not be able to read* This 
presents no problem unless permanent files created on a Rl«l*2 
system or later must be used on a system older than Rl»l*2* 
Should this situation a.rl se» contact Central Software Support for 
guidance* 

3. A new version <V1*1) of object code library format has been 
implemented to support improved message template capabilities* 
Hessage template modules are now created through the OCU 
CREATE.rtESSAGE.MODULE subcommand which places message template 
modules on the object library. The OCU on the Rl.l*2 system can 
accept object modules froir both old {VI. 01 and new {Vl*ll 

generate new (VI* 1) format libraries* 
the R.i*1.2 OCU cannot be used by previous 

or previous versions of OCU* Object 
procedures or program descriptions! can be 



libraries but will only 
Libraries created by 
versions of the system 

modules (but not SCL 



moved from a Vl*l library to a V1*0 library as follows: 

a* Using the VI. 1 CREOL* do the following! 

CREOL 

ADDM vll.llbrary "version VI. 1 library** 
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G€NL obJect.fHe f»f "generates an object file" 

b. Using the VI. CREOL"* do the following* 

CREOL 

AOOM object.fi le "generated as above" 

GENL vlO.llbrary "version V1.0 object library" 

4* Previous versions of message template modules cannot be used by 
the Rl.1.2 system. They must be rebuilt using the 
GENERATE_MES$AGE_TEHPLATE procedure. A MODULE statement must be 
placed at the beginning and a NDDEND statement at the end of the 
message template definitions in order to provide the name for the 
message template module on the QCU library* The message template 
module should be placed on the same library as the program 
description and CY8II modules for the application program. 

5* A new version {VI .1) of source code library format has been 
implemented to support current and future performance 
improvements* It wi I I be necessary to convert all older {pre 
Rl.1.2) source libraries with a utility described in Section 5.5. 

6. Changes to the program interface require the reconpi I at ion of all 
CYSXL modules. Hoduies which have not been recompiled may 
encounter »declaration mismatch 1 errors when they are loaded. In 
addition* any modules bound *ith runtime libraries will have to be 
rebound . 

7. Tape usage is restricted to permanent file backup/restore* and 
dump analyzer operations* 

8. Rl.1.2 changes the operator interface to NOS/VE from the 
combination of the K-display and MOD interface to a single CDC 
CC634B terminal connected via cable AV117A to the mainframe's two 
port multiplexor. The ^OS/VE system console should be connected 
to port of the two port multiplexor to allow RTA access via port 
1. 

The new NOS/VE system console orovldes access to the operator 
facility* system core debugger. the refreshing displays under 
VEDISPLAY* and an operator actions display. This console allows 
use of full ASCII for all key-ins. 

A single CC6348 can be used for both NOS and NOS/VE on the model 
8I0/830 systems* However* only one operating system can use the 
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system console at a given instant* The F6 key must be used to 
snitch ownership of the system console between NOS and NOS/VE* 

For all other model sxx mainframes supported 1 by N0S/V£# the C170 
state operating system ail I continue to use the CC545 console and 
NOS/VE *Mt use the CC634S as its system console. 

In several sections of this document* PSR numbers are given fol lowing a 
problem description. Additional information about the problem iaay be 
obtained from SOLVER by using this number. 
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2.0 ££AIU&£S.4a&-£&Qai£IS 



The products associated with NOS/V.S Rl.1,2 level 530 are documented in 
detail in the Software Availability Bulletin* Please refer to that 
document for this information* 
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3.0 lasiALUim-Aaa-flEmiifltii-Hans 

3.1 lasIAkUIIfla 
3.1.1 NQS INSTALLATION 

1. Both PASSON and XRHF must run out of the SYSTEMX account in order 
to access NOS output queue files *hich are transmitted to the 
NOS/VE input queue. If your site has changed the password of the 
SYSTEHX user* then you must after the USER statements in the 
RUNJOBS procedure. Enter the following statements under the user 
name from nhich NOS/VE is being deadstarted: 

CGHJ1GN* SY3TEH. 

GTR#SYSTE«#NVELI8#U.ULI8WELI8. 

G£TPR0C#RUNJ0BS. 

*Change at! USER statement oasswords to your site's value 

FSEjRUNJOBS. 

♦NVEffff. adds DSTLIB to the library set 

REPPROC* RUNJOBS *L«DSTL IB. 

*Change DSTLIB from seml-sr i v ate to private 

CHANGE>DSTLI8/CT-P. 

2. In order to use the ST*HVE parameter to route a file to the input 
queue* the user must have CUST validation flag set. 

3. The NQS system must have a LID table defined containing a PID of 
NVE with a LID of NVE. Neither entry has attributes. 

*t. A skeleton file (ACCOUNT) is created during deadstart and used by 
Interim Remote Host and Interstate Communications to generate 
partner jobs that are submitted to NOS. This file is created 
uithin a procedure named ACCFILE ^hich is located in user library 
NVELI8. Currently* the ACCOUMT file created will contain the 
f ol I owl ngt 

SJ08. 

US£R*£USeR*£PASStfQRQ.J 
CHARGE* SCHARG£*£PROJECT. 
/EOR 

When an Interstate Communications job <G£TF# R£PF» CREIC) Is 
executed* the partner job is created using the ACCOUNT file to set 
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up NQS accounting for the N*DS batch job. The field «£JQ8» causes 
the job card that was created within Interstate Communications to 
be put in its Place. The fields »SUSE8«> *£PASSWQRD»* *£CHARG£«* 
and '^PROJECT* are filled in with the accounting information 
entered by the user ahen executing a SET.LINK.ATTRIBUTES command. 
Interim Remote Host uses the ACCOUNT file in the same way. 

If the charge and project numbers were not specified on the 
SETJ.INK.ATTRIBUTES command the characters '*.* are substituted 
for f £CHAR€£* and blanks for '^PROJECT 1 . This implies that 
default charge will be used by NQS and the user must have the 
correct charge and project numbers specified under MODVAL. 

Changes can be made to the ACCOUNT file so that a site may create 
their own accounting file for Remote Host and Interstate 
Communications jobs. 

a. Get the user library NVELI8 from the system in order to change the 
ACCFILE procedure. 

b. Extract the procedure ACCFILE fro* NVELIB. 

GETPRQC#ACCFILfc>NV£LI3. 

c. Modify the procedure defined in this file by inserting the control 
cards necessary for accounting validation. 

d. Place the procedure onto DSTLI9. 

REPPRQC#ACCFILE#DSTLI8. 

This section documents the differences between NOS/VE 1.1.1 and 
NQS/Vfc 1.1.2. It concentrates on the changes affecting those sites 
whichtailoredt 

1. system start up commands 

2* system shut down commands 

3. command libraries 

4. system prologs and epilogs 

according to the NOS/VE 1.1.1 Installation and Upgrade flanual 
(604639138). Reloading of permanent files at NOS/VE 1.1.2 is also 

di scussed. 
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3*2.1 SYSTEM START UP COMMANDS 

Previously you modified record STAUC in the HOS file NVELI8. At 
1.1.2* you should place your system start up commands in the fiiei 

$sys tern. s tar t_up. commands 

This file is created only by an installation deadstart* with files 
being reloaded from the REQUIRED tape U«e.# the first time you 
install NOS /VE 1.1.2). 

Examine the contents of Ss ys ten* st ar t_up. commands* and if you want 
to change the commands* simply overwrite this file with the 
commands you want executed.? Possible commands includes 

1. set.def au I t_f ami I y 

2. set.job.cl ass.l iai ts 

3. set_command_l ist Cfor the operator command list) 

You may also wish to execute certain commands based on the type of 
deadstart being performed. You can determine the type of deadstart 
by testing the value of the variable r av$l oad.opt ion* which may 
have these values. 

•INSTALL* Installation deadstart was performed* the 

value of set.fi I e.i oaindg_opti ons Mas set 

to install Cthe default value for an 
installation deadstart). 

•RELOAD 1 Installation deadstart* the value of 

set.f i I e.l oadi ng.opt ions was set to reload* 

f NORMAL* Continuation deadstart* the value of 

set.fi I e.l oadi ng.opti ons was set to normal 
Cthe default value for a continuation 
deadstart) • 

•UPGRADE 1 Continuation deadstart* the value of 

set.f ile.l oad i ng.opt ions was set to 

upgrade. 

•INSTALL. DEFERRED.FILES«Coitinuation deadstart* the value of 

set.f i I e.l oai ndg_opti ons was set to 

ins tail. defer red.fi les. 
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3.2.2 SYSTEH SHUT DOWN COMMANDS 

At NQS/VE 1.1. 1# this file was record SHUDC on the NGS file NVELIB. 
The file 

Ssystem*shut a .down.comnamds 
is created the first time you install NQS/VE 1.1.2. Overwrite this 
file with any commands you wish to be executed during system shut 
down. 

3.2.3 SITE COMMAND LIBRARY 

At NOS/VE 1.1. 1, the fi le 

Ssystem.osf $si te_command_l i br ary 
was created from record 1SFSCL on the NOS file NVELIB. Any 
procedures you wished users to have as part of their command lists 
could be placed in this file* as it was added by the system prolog 
to users* command lists. 

This file is now reserved for CDC* and the system is released such 
that this fie is no longer automatically added to users 1 command 
I i sts* 

Procedures you want to make accessible to your users should be 
placed on another command library* and the system prolog should be 
modified appropriately (sea halo*). 

3.2.4 OPERATOR COMMAND LI8RARY 

At NOS/VE 1.1. If the fi ie 

Ssystem.os f$oper at or ..commands I ibr ary 
was created from record OSFOCL on the NQS file NVELIB. Any 
procedures you wished your operators to have as part of their 
command lists could be placed in this filet as it was part of the 
operator's command list. 

This file is now reserved for COC# but it is still in the 
operator's command list. 

Procedures you want to make accessible to your operators should be 
Placed on another command library* and the system start up commands 
(see above) should be modified appropriately to also add your 
operator command library to the operator's command list. 

Should you have to reload permanent files* your operator command 
library will not be available until files are reloaded. This 
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should not be a problem* wvlsss you want to use a restore procedure 
different from the one supplied by CDC. In this case* place your 
procedure on the HOS fiie SIT6CP (just like the CDC restore 
procedure) and rebuild your deadstart file with REPRECS. This 
procedure will then be made a Permanent file under $SYST£H for any 
installation deadstarts. 

3.2.5 SYSTEH PROLOGS ANO EPILOGS 

At NQS/V£ 1.1.1 » the systei prolog executed commands which added: 

1. $system.scu. mai ntenarjce.command^l i brary 

2* Ssystem.os f$si te_command_ri or ar y 

The released system prolog no longer contains these commands. 
Also* the first library has been renamed toi 
$system*scu*command_l i brary 

If you want to add these iar other) libraries to users* command 
lists j create a neu cycle of the fiie 

$sys tern. pro logs.and.ep i I ogs. system_prolog 
and include commands to add these libraries to the user's command 
I i st* 

3.2.6 RELOADING FILES 

Perform the following steps if you have to reload your permanent 
file base. 

1* Execute an installation deadstart* but using a NVE procedure 
file which pauses for operator system core commands. Enter 
the system core commands* 

inltdd ?????? 

GO 

Note that the GO must be uppercase* and you do not enter the 
auto system core command* 

2. Deadstart will eventual ly pause with the set file loading 
options display. Enter J 

set.f i I e_l oad i ng.opt ion load_option*reload 

GO 
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3* After deadstart completes* execute the permanent file reload 
procedure* 

attacfi_.fi I e $systetiu restore 
restore 

Hote that if you write your own permanent file reload 
procedure (see the Tperator Command Library section) yoy 
Mould attach your procedure instead. 

4* After files are reloaded* enters 

create_f ami I y nve ' ad?ni n i str atcr-user-name* 
i ncl ude_f i I e $sys ta*« star t.yp.coinfliand.5 
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3*2*7 NOS/VE INSTALLATION 

1# Table 1-1 and 2-2 of the HQS/Vt Installation and Upgrade Manual 
should be expanded to include the larger memories supported by 
release 1«1*2# The expanded table Is shown below: 



CM 


CM WORDS 


M WORDS 


CH WORDS 


CM BYTES 


CM BYTES 


SIZE 


C OCTAL) 


(DECIMAL) 


(HEX) 


{DECIMAL) 


< HE X ) 


i m 


4000000 


131072 


20000 


1048576 


100000 


z m 


100O0000 


262144 


40000 


2097152 


200000 


3 HQ 


14000000 


393216 


60000 


3145728 


300000 


4 H8 


20000000 


524283 


a oooo 


4194304 


400000 


5 m 


24000000 


655363 


OAOOOO 


5242880 


500000 


6 m 


30000000 


786432 


DC00D0 


6291456 


600000 


i m 


34000000 


917504 


OEOOOO 


7340032 


700000 


a H8 


40000000 


1048576 


100000 


8388608 


800000 


9 H3 


44000000 


1179648 


120000 


9437184 


900000 


10 HB 


50000000 


131072 


140000 


10485760 


OAOOOOO 


11 MB 


54000000 


1441792 


160000 


11534336 


0800000 


12 H8 


60000000 


15 7286 4 


180000 


12582912 


ocooooo 


13 HB 


64000000 


1703936 


i'AOOOO 


13631488 


0D00000 


14 H8 


70000000 


18 35038 


1C0000 


14680064 


OEOOOOO 


15 H8 


74000000 


196608 


IEOO0O 


15728640 


OFOOOOO 


16 H8 


100000000 


2097152 


200000 


16777216 


1000000 


17 MB 


104000000 


2228224 


220000 


17825792 


1100000 


18 H8 


no 000000 


2359296 


240000 


18874368 


1200000 


19 MB 


114000000 


24 90368 


260000 


19922944 


1300000 


20 HB 


120000000 


2621440 


280000 


20971520 


1400000 


21 na 


124000000 


2752512 


240000 


22020096 


1500000 


22 H8 


130000000 


2883534 


2C0OOO 


23068672 


1600000 


23 H8 


134000000 


301465 6 


2E00D0 


24117248 


1700000 


24 MB 


140000000 


31457? 8 


300000 


25165824 


1800000 


25 MB 


144000000 


3276830 


320000 


26214400 


1900000 


26 H8 


150000000 


3407872 


340000 


27262976 


1A00000 


27 MB 


154000000 


3538944 


360000 


28311552 


1800000 


28 MB 


160000000 


3670016 


380000 


29360128 


1C00000 


29 HB 


164000000 


3801038 


3AOO0O 


30408704 


1D00000 


30 MS 


170000000 


3932160 


3COO0O 


31457280 


1E00000 


31 MB 


174000000 


406323 2 


3E0O0O 


32505856 


1F00000 


32 MB 


200000000 


4194304 


400000 


33554432 


2000000 



2. tfhen upgrading from an ear "1 1 er NOS/VE release to NOS/VE Release 
1«1»2 you must backup your existing NOS/VE permanent files* 
deadstart NOS/VE Release 1«1»2» and restore your NOS/VE permanent 
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a. Once you have generated the NQS/VE Release 1.1.2 Oeadstart 
Input file as described in chapter two of the Installation 
and Upgrade manual* enter the following command from the 
operator console to terminate your current NQS/VE system* 
TERHZNATE.SYSTEM 

b. Oeadstart NOS 2.4.1 level 630 or NOS/BE 1.5 level 627 and 
NQS/VE Release 1.1.2. Be sure to use a deadstart procedure 
file for MQS/VE that enables operator intervention prior to 
system core command orocassing. Refer to the SETVE 
procedure documentation in the Installation and Upgrade 
manual when creating this deadstart procedure file. 

c. When "ENTER SYSTEM CORE COMMANDS" appears on the operator 
console* enter J 

INITDO <v$n> ''where <vsn> identifies the deadstart device" 
GO (GO must be upper* easel 

d. When the file loading option display appears on the operator 
console* enter* 

SET.FILE.LQAOING.QPTION RELOAD* 
GO 

e. When the message "DEADSTART COMPLETE** appears on the 
operator console* restore your permanent file base from the 
previous level of MOS/VE. Details of permanent file 
restoration may be found in the NQS/VE Operations Hanual 
(60463914). 



If the $SYST£*I files backed up from your prior NQS/VE 
release were created or modified by your site* they may be 
incompatible with NQS/VE Release 1.1.2. You should identify 
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which of these SSYSTTi files- are to foe retained from the 
prior release* and be prepared to verify these files once 

NQS/VE Release 1.1.2 has been installed* 

f» Enter the Create.FauMy command for all fannies which yoy 
restored* excluding the « $Sf ST£H family. Ignore the 
diagnostic issued by the Cr eate_Fami I y command which 
indicates that the family user administrator^ master 
catalog already exists for the family you restored* 

g* Enter the following, command from the operator console* 

TERMINATE.SYSTEH 

h* Qeadstart NOS/VE Release 1*1.2 a second time. Use the same 
deadstart procedure file that was used for the previous 
NOS/VE Release 1.1.2 deadstart* 

i. tibzn "ENTER SYSTEM CORE COHNANOS" appears on the operator 
console* enter? 

GO 

j. When the file ioadion option display appears* enter* 
SET.FILE.LOADING OPTION UPGRADE 
SO 

Follow the directions outlined in Chapter 8 of the NOS/VE 
Installation and Upgrade Manual (60463913). 

k. To determine SSYS'TEM catalog content* and the sizes of files 
installed in the $SYSTE$ catalog* enter these commands from 
the operator console: 

DISPLAY. CATALOG $SYST?*1 DQ»C D'ALL Q = XX 
PRINT.FUE XX 

I. Login to NOS/VE Release 1.1.2 from an interactive terminal 
and enter the commands* 

setcl a»< $ system .osf$s i te.command.l Ibrary* 

$sys tern* scu. command. I i hr ar y) 
Ver i f y.Instai I ed„Sof tware 

One or more messages wi I I be displayed for each product you 
have install ed« 

3. Remote installation and maintenance of the operating system 
requires an analyst or operator he present at the operator's 
console. 
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If your site has the CYBER 170 APL2 installed* and desires to 
migrate APL applications to the CYBER 180* AFIFIX should be 
replaced ynder user number APL0. AFIFIX* a 170 resident permanent 
file* now has the added capability of being a pre-processor for 
the 180 APL workspace CONVERT. APL2. Installation instructions are 
described in this section* refer to the APL section in Product Set 
Notes and Cautions for usage Information* 

The first step of installation is to create the following NQS/VE 
job to move the NQS/VE file to NOS. It nay be created as a NOS or 
NQS/VE text file. This text file is then accessed from the 
operator console* using the attach.fi ie or get.fi le command* The 
include.fi le comand is executed to submit this job as a Ssystem 
f ami I y batch job* 

(Notes User APLO has an installation definable password} the 

default* APLO* is being used for example* It is assumed that the 

CYBER 170 AFIFIX already properly exists In user APLO as an 
indirect and public file.) 

J08*M0V£APL 

WHEN any.f aul t 00 

displ ay. value osvSstatus outPUt*$response 

request. operator. action message*' AFIFIX HOVE FAILED f 

logout 

WHENEND 

set.l i nk.attr ibutes user ■( APLO NOS) password«APLO 
replace.fi le from*$system. ao I ,mai ntenance. af i f i x *• 
to=afiflx dc=B6Q 

JQ8END 

If you have been installing and supporting NOS/VE systems prior to 
Release 1.1.2* then you nay be aware of the steps required to 
upgrade to a newer level of NOS/VE (specifically template 
installation). This process has become obsolete with this system. 
NQS/VE now uses the system core and the job template from the 
deadstart media (NOS tape file or NOS disk file representing 
TPXXXK) as the source for any instance of NOS/VE deadstart* 
Consequently* the system core commands 'USESJT 1 and HJSERJT 1 (and 
their associated long forus) have been deleted from the system 
core command repertoire*! Therefore* these commands need to fee 
removed from a site*s DCFILE. 
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This means that to perform an upgrade deadstart* one merely needs 
to use the new deadstart file and perform a continuation 
deads tart* 

6. Interim Remote Host partner jobs are submitted as batch origin 
jobs with the advent of HOS 2.3* Problems with the commands 
G£T_FIL£ and REPLA€£J=IlE occur when the NOS system batch Job 
limit is set too low. This could cause GET_FIL£ and R£PLAt£_FIL£ 
to fail with the error message "UNABLE TO COMMUNICATE WITH HOS 170 
REHOTE HOST". What happens is that when doing one of these 
commands* a partner job gets spun off and is submitted as a batch 
job to NOS. If there are enough batch jobs running to reach the 
batch job limit* the partner Job will be put in the NOS input 
queue to wait for one of the batch jobs to finish. The 180 side 
waits for the partner job to finish. If the 180 side does not get 
a response from the partner job within 10 minutes* then it will 
time out and issue the error message above. To get around this 
problem* we recommend that the batch limit be set to 20 to 50 or 
more depending on the use of file transfer through Remote Host and 
Interstate Communication in your system. The maximum number of 
Remote Host and Interstate Communication jobs that can be running 
at one time is 50. 

NOTE? Interstate communication jobs do not time out on the 180 
side. They will wait until the partner job gets rolled in and 
finishes before they continue one. 

7. The NOS/VE Analysis Manual (59463915) contains discussion on the 
events that take place within NOS/VE for the different types of 
deadstarts performed by NOS/VE. One of the types of deadstarts is 
a recovery deadstart which is performed primarily after NOS/VE has 
been terminated by the TERHINATE_SYSTEM command. The purpose of 
the recovery deadstart is to assure that all mass storage 
transactions in central memory have been processed to update the 
mass storage device (i.e.* central memory and mass storage agree 
on the state of a file). 

The NOS/VE Analysis Hanual incorrectly implies that one enters the 
*INITDD» command when the »€N?ER SYSTEM CORE COMMANDS 1 prompt 
appears during a recovery deadstart (if operator intervention is 
selected). Note that this is incorrect and will not be accepted 
by NOS/VE. An appropriate error message will be displayed 
(•INITDO HOT ALLOWED DURING RECOVERY*) and HOS/VE then awaits any 
additional system core commands (i.e.* •AUTO'). 



3-12 
SOFTWARE RELEASE BULLETIN 

85/03/29 
NOS/VE Rl.1.2 LEVEL 630 



3.0 INSTALLATION AND OPERATIONS NOTES 
3.2.8 NOS/BE INSTALLATION 



3.2.8 HQ5/8E INSTALLATION 

1. To login to NOS/VE from am interactive terminal* you must first be 
validated to log in to N0S/8E INTERCOM 5.X. INTERCOM users are 
validated by use of the F4SSWR?) utility as described in the 8flSZfi£ 
Iai£lill£iP.Q~tllMI>££lS* Xn order for an INTERCOM user to log in to 
NOS/VE* he must have a valid N05/VE user name as one of his 
INTERCOM password parameters.; The user must enter the following 
command after logging in to INTERCOM in order to log in to NOS/VE* 

vei af 

The VEIAF utility Is an INTERCOM multi user job which will take 
the NOS/VE user name for the current INTERCOM user from the 
Password file and initiate a login sequence with the NOS/VE 
Interactive Facility. After successful login* NOS/VE messages 
similar to the following 4ill be displayed J 

Wei come to the NOS/VE Software System. 
Copyright Control Data 1984. 
C170~835 SN2. NOS/VE Rl. 
September 13* 1984. 1*34 pm. 

VEIAF will continue to function as the interface between the 
INTERCOM user and the MOS/Vt Interactive Facility until the 
session is complete. 

2. Interactive processing on NOS/VE in a NOS/BE dual-state 
environment is as described in the SCL for MO££¥£-£lSi£t-Iai£££a££ 
Haau3i with the exception of the interactive control of commands. 

NOS/VE recognizes both a pause break and a terminate break 
condition. INTERCOM 5.X recognizes only one break condition which 
is caused by entering V^A* at the terminal* Use of f ?A f will 
cause the currently executing NOS/VE command to enter a pause 
break condition In order to effect a terminate break condition* 
the user must first enter 'lA* to enter pause break followed by a 
TERMINATE.COMMANOCTERC J to terminate the suspended command. 

3. The NOS/VE GET.FILE and REm.ACE_.FILE commands used to access 
170-side permanent files have been modified to include NQS/SE 
cycles* passwords* and ID*s. NOS/BE files accessed with tiese 
commands must be resident on the default permanent file set. 

The format of the GET^FILE command is as follows* 
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GET.FILEIGETF) 
TO«f i le reference 

CFROH^namel 

COATA_CONVERSION»keyword valyel 

€ID s name1 

CPASSWQRD-list I. .2 of name! 

CCYCLE-lnteger 1..9991 

£STATUS*status variable! 

The FRQflCF}* IDCID)» PASSWGRD(PVf) and CYCLECC) parameters specify 
the same information that would normally be supplied on a N0S/8E 
ATTACH command* That is* FROH specifies the file to be accessed* 
ID specifies the file id* PASSWORD specifies a list of up to two 
passwords that may he supplied in accessing the file (turnkey and 
read permissions are the only passwords that would be meaningful 
for a GET. FILE command)* and CYCLE specifies the N0S/8E file cycle 
number. The system generates the NQS/8E ATTACH command using 
these values an4$ if access is granted* copies the file to a 
NOS/VE file. 

The TQ<T> parameter specifies an SCL file reference. If the FROM 
parameter is omitted* the file specified by the TQ parameter is 
used (since the NQS/BE permanent file structure uses only one 
catalog* just the file naie Part of the file reference is used to 
access the MQS/BE file}* 

The ID parameter is not required if the NOS/BE file id is the same 
as the current NOS/VE user name* or user name specified in the 
last SET_LINK_ATTRX8UTE command. The PASSWORD parameters are 
required only if turnkey and/or read permissions are required to 
access the file* The CYCLE parameter is required only if the file 
being acquired is not the highest cycle cataloged* 

The REPLACE.FILE command is used to copy a NOS/VE file to a NOS/BE 
file* The file on the MOS/3? system can oe an existing or new 
permanent file* 

If no N0S/8E file of the same name and id exists* a new file is 
created* 

If a NOS/BE file of the same name and Id exists* a new cycle of 

the file is created* If creation of a new cycle would result in 

more than 5 cycles* the lowest cycle of the file will be purged as 
part of the REPLACE.FILE operation. 
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The format of the REPLACE. FILE command is as follows. 

REPLACE.FILEtREPF) 

FROH*flle reference 

£T0 B name3 

£DATA_CONVERSiaN«keyword value! 

£ID*name] 

CTURNKEY*name3 

£XR*nane3 

£CYCLE»integer 1..9993 

CSTATUS-s tatus variable! 

The T0(T)* IDCID)* CYCLE*:** TURNKEY (TK) and XR parameters specify 
the same information that would normally be supplied on a N0S/8E 
CATALOG command. That is* Til specifies the file to be cataloged* 
10 specifies the file id> TURNKEY and XRCcontrol* extend and 
modify) specify NOS/SE permanent file permissions* and CYCLE 
specifies a N0S/8E file cycle number. The system copies the file 
to the NQS/8E default permanent file set and generates a CATALOG 
macro to make the file permanent. 

The FROM parameter specifies an SCL file reference. If the T0(T) 
parameter is omitted* the file sped fled by the FROM parameter is 
used and the file name part must conform to NOS/BE permanent file 
naming conventions* except the length will be limited to 31 
char acters * 

The ID parameter is not required if the NOS/BE file id is the same 
as the current user name* or name specified in the last 
S£T_LINK_ATTRIBUTE command. The CYCLE parameter is required only 
if a specific cycle of the file is to be replaced. 

The TURNKEY parameter is required only if the user desires to 
prevent vent all access to the file unless the turnkey password is 
specified. The XR parameter is required if the user desires to 
allow read permission only unless the XR parameter is specified. 
If turnkey and /or XR passwords are specified when a NQS/BE file is 
initially created* they must he specified in ail subsequent uses 
of REPLACE.FILE on this file. 

h. A NOS/VE job can be submitted fro* NOS/BE by creating a HOS/BE 
file containing a NOS/VE Job image and using the NOS/BE ROUTE 
command with a logical id of NVE to submit the job to the NOS/VE 
input queue. The format of the ROUTE command for this operation 
i s as f oi I ows. 
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ROUTE (f i le,DC*IN,ST»Hyfc> 

The NVE LID must not be defined for the host NOS/BE system or it 
will attempt to process the NOS/VE- jobs as NOS/BE jobs* 

5. N0S/8E support of the SET_T£RNINAL_ATTRIBUTES command is as 

foil QMS J 

a* The following parameters have fixed values that can not be 
changed! 

ABORT.LINE.CHARACTE^ %$ 

8ACKSPACE.CHARACTER BS 

CANC£L_LINE_CHARACTER CAN 

CARRIAGE.RETURN.IDLE 

ECHOPLEX 

INPUT_DE¥IC£ keyboard 

LINE.FEEO.IOLE 

NETWORK_CONTROl.CHA*ACrER ESC 

OUTPUT.OEVICE display 

OUTPUT.FLOW.CONTROL none 

OUTPUTS/TRANSLATION none 

PAUSE.BREAK.CHARACTH-R %k 

TRANSPARENTJDELIH.SE LECTION C true, false. f al se) 

TRANSPARENT_€ND_CHARACTER CR 

TRAMSPARENT.CHARACTe-R.CQUNT" 2044 

b. The following parameters are set by INTERCOM according to 
the terminal class prior to logging in to NQS/VE* and cannot 
be changed! 

HOID.PAGE 
PAGE_LENGTH 
PAGE.WIDTH 
TERMINAL.CLASS 

c. The PARITY parameter is based on terminal class, it may be 
changed by the NQS/VE user, but has no effect unless 
transparent mode has been selected* True transparent mode 
requires a parity setting of NONE, any other setting will 
force the default terminal parity to be used. In all cases, 
the parity bit is set to zero before input data is 
delivered. 

d. The TERHINATE_3REAK_CHARACTER is not supported. 
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e. TYPE. AHEAD is always. true 
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1. NOS/VE *i 1 I not support more than 10 tasks concurrently defined 
per job. The system does not enforce this limit! users must be 
careful not to exceed this limit or they may cause the system to 
hang. 
RSE NVEA133 
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3.4 fl££aAiQE.£flaflAuas 

1. Restarting IRHF and tfEXEZ on the 180 Side 

IRHF moves NOS/VE input and output from and to NQS. It has a NOS 
partner job also called IRHF. IFEXEC is the NOS/VE interactive 
task. It has a NOS partner job called PASSON which is the NAM 
appl icat Ion VEIAF. 

IRHF should automatically restart if it aborts* To bring up IRHF 
manually* the operator must first bring down IRHF* then bring it 
up again. The same holds true for IFEXEC. 

To bring down IRHF* enter at the 180 NOS/VE operator's console? 

OSACTIVATE.SYSTEM.TASKS TA$K_NA1ES«RHINPUT 
OEACTIVATE_SYSTEH_TASKS TASK.NAMES-RHOUTPUT 

Then to bring IRHF back up> enter at the 180 HOS/VE operator's 
conso I e i 

ACTIVATE_SYSTEH_TASKS T4S*_NAHES«RHINPUT 
ACTIVATE_$YST£i1_TASKS TASK_NAM£S»RHOUTPUT 

To bring down IFEXEC* enter at the 180 NOS/VE operator's console: 

D£ ACT I VATE.SYSTEM. TASKS TASK_NA*1ES -IFEXEC 

Then to bring IFEXEC back up* enter at the 180 HOS/VE operator's 
consoles 

ACTIVATE.SYSTEMJTASKS TAS K.N AHS S- IFEXEC 

2. Restarting IRHF and PASSON on the NOS Side 

To make provisions for restarting IRHF and PASSON* two procedures 
have been provided. These are *S5IRHF and HSSPASS and are located 
in User Index 37777?. 

IRHF is restarted by simply typing the following in at the 170 
operator's console! 

HSSIRHF. 

PASSQM is restarted by entering? 
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MSSPASS. 

Note: Changes sdere made to procedure RUNJOBS to allow for PASSQN 
to restart itself whenever it aborts abnormally* If PAS SON aborts 
abnormally* the system **i I I attempt to restart PASSQN 
automatically. If HAM goes doun* PASSQN will not be automatically 
restarted. 

3. The NOS application (VEIAF) that connects NOS/VE jobs to NAM Hill 
so me tidies produce the flashing console message: 

"PASSQN ABNORMAL 19* 

This message weans PASSON is discarding an unsolicited message 
generated between VEIAF and the first read request from NOS/VE* 

This should be ignored. Clear the message with •GQ.jsn*' 

See Section 3.9.1 for PASSON di agnostic messages. 

4. The operator should not enter any command at the operator's 
console that requires a magnetic tape. This will generally yield 
a deadlock condition. All requests should come from other than 
the system job. This will peril t assignment of equipment from tne 
operator's console. 

5* Restarting IRHF on the M0S/3E side. 

To make provision for restarting IRHF» an operator initiated 
procedure has been provided. Simply type* 

nn.X RUNIRHF. 
where nn is a clear control point number. 
6. PASSON Abnormal Processing (NOS/BE) 

During periods of heavy interactive usage* the messages 

PASSON ABNORMAL 

may appear on the NOS/BE job status (8) display* Unless related 
to a problem that a user has reported. this message does not 
necessarily indicate an error condition. 
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When PASSON ABNORMAL appears on the system console screen* record 
the number of the message for your site analyst's use* 

If your analyst asks you to examine the dayfile of the PASSON job* 
enter the following command* 

A«NN. 

NN is the control point number of the PASSON job* 

Examine the dayfile for the nessage. The message format is* 

HEX OATA FOR PASSON CONOITIOi-MESSAGE NUMBER 

The message is followed by one or more lines of hexadecimal 
data which your site analyst may ask you to record* 

See Section 3*9*1 for PASSON diagnostic messages* 

7. The INITIALIZE_DEADSTART_DEV"ICE system core command and the 
INITIALIZ£J1S_V0LUM£ Logic*! Configuration Utility subcommand do 
not warn the operator that the volume has been previously 
initialized* This is of particular concern in 
INITIALIZERS. VOLUME because the operator may misspell the 
el enent.nane of the device and inadvertently destroy permanent 
f i I e s * 

8* In order to freeze the (Sisal ay on the NOS/VE operators console 
while it is rapidly updating* *e suggest using the 'SETUP* key. 
Pressing the 'SETUP' key Mill cause the console to stop accepting 
data from the host which *ifl immediately halt the display* The 
lower two lines will be temporarily overwritten with the setup 
option display* Pressing the 'F!' key will allow the display to 
resume updating, 

9* If the operator accidentally assigns a VE tape to the wrong V£ 

job* then no indication of this situation is given and the tape 

remains attached to the Cwronq) job until it ends* 
PSR NV0E854 

10* There are two operator commands available for manual job swapping* 
These are 

StfAPQUT <JSN> and 
SWAPIN <JSN> 
<JSN> is the system job name of the job to be swapped. 
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If the job is to be swapped in* using the OISSJ command will 
provide the JSN necessary for the SWAPIN command, vlhen a job is 
snapped oyt using the SWAPOUT command.* it mHI regain snapped out 
until the S^APIN command, is executed. 

II. i*Jhen an operator makes an error on an ASSIGN.OEVICE (ASSO) 
command* the tape request message will be replaced by an error 
message. The operator should acknowledge the error by entering 
the REPLY_ACTIQN CREPA) command *i th the appropriate job name* 
The error message Mill be clearedt and the original tape request 
message m! M reappear* allowing the ASSIGN„DEVICE to be retried. 



SOFTWARE RELEASE BULLETIN 
NQS/VE Rl.1.2 LEVEL 630 



85/03/29 



3.0 INSTALLATION AND OPERATIONS NOTES 
3.3 CONFIGURATION MANAGEMENT 



b*s £aa£isyEAiiaii.-i4fiMiE£Mi 

1. The physical and logical configuration utilities can only be 
invoked by name from the system console* Ail other users must use 
the EXECUTE.TASK command as sho*n here: 

EXECUTE.TASK STARTING.PROCEDURc « M4NAG£_PHYSICAL_C0NFIGURATIQN 

2. The name ALL is a reserved element name and should not be used in 
any element definitions* 

3. When running the Physical Configuration Utility <?CU) from an 
interactive terminal* the include.fi le command will return an 
error stating that the included file is not callable. In order to 
test the configuration* enter the PCU* then copy the test file to 
another local file* You no* can include_file the new local file* 

4. Serial number uniqueness is now enforced by the Physical 
Configuration Utility* When defining elements in the 
configuration prolog* care must be taken to specify a unique 
serial number for each element* The only exception to this is for 
mul t i-spindl e devices such as 88 5-lx. 

5. For 330 dual CPU installation to run NOS/VE dual CPU* when "ENTER 
SYSTEM CORE COMMANDS* appears on the NOS/VE operator console* 
enter the following* 

SETSA ENA8L£_MULTIPR3CSSSING 1 

This command is temporary and will be removed in 1.1.3. 

6. NOS/VE cannot run on CPU 1 of a dual CPU configuration if CPU 
is off or down* 

7. The following error messages are not included in the diagnostic 
manual for Rl.1.2: 



— ERROR— THE ACTIVE LOGICAL CQNFIGURATI 



IS EMPTY. 



Product Identifier: CI condition: 350410 
Condition Identifier: C15$LCH.EMPTY.LC 

Description: The logical configuration was defined before the 
physical configuration In the configuration prolog. 
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User Action* Define the physical configuration in the 
configuration prolog before you define the logical 
conf i gur ati on. 

— ERROR— INCOMPATIBLE LOGICAL CONFIGURATION FILE. 

Product Identifier* CI conditions 330*05 
Condition Identifiers C^ESLCM.INCQMPATIBLE.LC 

Description* Encountered an internal file problem. 

User Action* Reexecute the logical configuration utility* If 
the error reoccurs* execute both the physical and logical 
configuration utilities to define the physical and logical 
configurations. If the error persists* contact Control Data 
field support 

— ERROR— PERMISSION NOT GRANTED FOR €text>. 

Product Identifier* CI condition* 350430 

Condition Identifier* CMESLCI.RING.VALIDATIONJERROR 

Description* User does lot have ring privilage to execute the 
program interfaces or command* 

User Action* Request the aooropriate ring privilege frost the 
family administrator* 

— ERROR— £text> HISSING II PHYSICAL ADDRESS SPECIFIER SET. 

Product Identifier* C« condition* 350435 

Condition Identifier* CMF$LCM_MISSINGJ>A_SET_MEMBER 

Description* Missing required set value in the physical address 
specifier set. 

User Action* Specify the appropriate set value in the physical 
specifier* i.e. to querv controller name* you need to specify 
cmc$channel and cmc$ch anne I _addr ess on the physical address 
specifier set. 

— ERROR— {text} 

Product Identifier* CM condition* 350455 
Condition Identifiers C"IS$LC1_ NOT. AVAILABLE 
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Descriptions User Is trying to use a feature not yet 

implemented* 

User Action! Contact Control Data Central Software Support* 

1* If any disk volume being used by NOS/VE becomes full* the 
following message will periodically appear on the consoles 

AAAAAA - out of space (date) (time) 
CAAAAAA is the vsn of the volume} 

Any task that is requesting space on a full volume will hang 
waiting for space. Some space may be obtained by 



the temporary file space that was in use. If the disk full 
caused by permanent files* then the disk will be nearly full a 
the recovery* and the archiving of permanent files or deletin 
some files must be done as soon as the system Is up. 

It is possible that a disk full situation will occur that cannot 
be recovered. This will have happened if the "out of space** 
message appears during a deadstart before the system is up {this 
usually will occur during the permanent file reorganization phase 
of deadstart — recognized by the "of recovery'* message at the 
console). In this case permanent file volumes must be initialized 
and reloaded from a previous backup dump. 

£. If a continuation deadstart fails after disk full with a NOS/VE 
CPU monitor fault* it is possible that the failure is due to 
unprinted files in the output queue* one or more of which are no 
longer printable. The failure is a job mode software failure and 
does not leave the Honitor Control Register set in monitor mode* 
The message indicating this failure is W HR - MONITOR FAULT*** 

Remedial actions 

Perform a continuation deadstart (with W*TRU£ so you can enter 
system core commands) and enter the following system core commands 

SET_SYSTEH_ATTRIBUTE HALTRING 
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This command Mill allow deadstart to complete. If you find that 
task RHOUTPUT has terminated {by looking at the system job log 
nith DXSSD* and files exist in the job output queue {DISC 
SSYSTEH.$J08.0UTPUT.QUEUE1 you can be reasonably sure that you 
have encountered this problem* 

Delete the contents of the job output queue (DELCC 
SSYSTEM.SJOB.OUTPUT.QUEUE)* terminate NOS/VE* and do another 
continuation deadstart. 

3.7 PEEMiMI-ElUUillLimS 

1. The power of the family administrator has been extended to allow 
backing up and deleting files for users in his family. 

3 * 8 caailAlia-L AMUAfi£-SIAIiSII£ 

The data that gets emi tted f or this statistic is the time and page 

faults for the task that calls the command. If the command spins off 

a task* then the data for that task is found under the task statistics 

and the command statistic will only contain the time and page faults 
for the initiating task. 



St at i stt c 

Name Description 



CIL7002 Command Resources. This statistic will 

collect and generate data for every command 
executed. It should only be used for test in 
or performance information gathering. 

The information generated by this statistic 

i ncl udes» 

DESCRIPTIVE DATA - command name 

COUNTER 1 - job node CP time 

COUNTER I - monitor mode CP time 

COUNTER 3 - total page faults 

COUNTER h -■ total page- ins 

COUNTER 5 ~ total page-reclaims 

COUNTER 5 - total Page-assigns 
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Dye to the large overhead incurred by using this statistic* it is 
conditional and must fee activated in the following manner* 

FROM THE CONSOLE ENTER* 

SETSA C0NHAN0.STATISTICS_.?NABLE3 TRUE 
ACTS CL17^ 



To deactivate the statistic* use the opposite of the above sequence. 

OEAS CL170002- 

SETSA €0HHAN0.STATISTICS.£NA3L£9 FALSE 

3.9 flMLIUE-flAMiAU 

1. The installation and upgrade of online manuals is documented in 
the NOS/VE Installation and Upgrade Usage Manual for Release 
1.1.2. The maintenance process is described in this section. 

The source for online manuals is being distributed to allow 
customers the capability of tailoring the manuals for their site* 
Source libraries contain a SCU feature reflecting the revision 
level documentation changes (example: feature VER_1_1_1 for 
Release 1.1.1) This not only gives the benefit of a "revision 
packet" to identify new capabilities and changes* but also aids 
the update process for the site version of manuals. 

To tailor a manual for a site? 

a. Create a new source library or additional cycle of 
$sys tern. manual s. mai n ten a nee. sour ce.l i brary ref I ecti ng the 
site modifications. (Note that each manual is contained in 
a deck. Decks are grouped by product.) 

b. Execute Ssystem. manual s.mai ntenance.bi nd lng_ procedure within 
the Ssystem user or maintenance user name to create new 
manual s. 

PROC bi nd_manual s» binrn* bind^manual 

manual, manuals, n * LIST OF NAME or KEY ail « all 
source_catalog, sc? FILE ■ %$ YSTEH. MANUALS. MAINTENANCE 
catalog* c* FILE » $USER. HANUALS 
status ) 

where. 
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manual * scu deckname(s) of lanuaMs) desired to be 

created 

source^catalog contains the source libraries used for 

compi I ation 

catalog * resultant catalog for new manuaHs) 

3.10 £fiaoa.a£iSAfi£S 

The following diagnostic messages have not bean included in NOS/VE 
manuals for Rl.1.2. They will be included in a future release. 

3.10.1 PASSON DIAGNOSTIC MfiSSAGS-S 

There are 28 distinct errors that PASSON indicates by issuing a 

'PASSON ABNORMAL* message at its control point. The cause of each 
error and its associated error code (issued in the. 'PASSON ABNORMAL 1 
message) are listed below. The error explanations assume a knowledge 
of the network concepts evinced in the NAM/CCP Reference Manual 
(publication number 60499500). 

1. PASSON ABNORMAL 

PASSON's attempt to sign on to the memory link failed with a fatal 
error status. PASSON terminates. 

2. PASSON ABNORMAL 1 

The memory link reported a fatal error status when PASSON 
attempted an ml p$add_s ender to permit itself to receive messages 
from any NQS/VE application, PASSON terminates. 

3. PASSON ABNORMAL 2 

PASSON does not begin interactive processing until NOS/VE's 

Interactive Facility's executive signals it to do so. In this 

casei the memory link reports a fatal error status while PASSON is 
awaiting the executive's signal. PASSON terminates. 

4. PASSON ABNORMAL 3 

An attempt to activate network message logging has failed because 
the logging code is not available. PASSON terminates. 

5. PASSON ABNORMAL 4 
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An attempt to activate network statistics accumulation has failed 
because the statistics accumulation code is not available. PASSON 
terminates* 

6. PASSON ABNORMAL 5 

The memory link reported! a fatal error status when PASSON 
attempted to receive a downline message from NQS/VE. PASSON 
issues the abnormal message and continues interactive processing. 

7. PASSON ABNORMAL 6 

After receiving a message from NOS/VE* PASSON has discovered that 
the message is neither a data message nor a supervisory message 
(the only 2 possibilities for application messages). PASSON 
issues the abnormal message and continues interactive processing. 

B. PASSON ABNORMAL 7 

NAM has signaled to PASSON (via the supervisory status word) that 
an upline supervisory message is available to relay to NOS/VE* but 
PASSON ascertains that the message is not a supervisory message* 
PASSON issues the abnormal message and continues interactive 
processing. 

9* PASSON ABNORMAL 8 

Not used* 

10. PASSON ABNORMAL 9 

PASSON has received a connection request supervisory message 
(CQN/REQ/R) from NAM for a connection which is already in use* 
The connection request is ignored. PASSON issues the abnormal 
message and continues interactive processing. 

11. PASSON ABNORMAL 10 

PASSON has received an ini ti a I i zed-connect i on (EC/XNIT/N) or an 
in i t i al i zed-connecti on request (FC/XNIT/R) supervisory message 
from NQS/VE or NAM* respee t i vei y* and the connection receiving the 
message is not at the appropriate stage of the connection 
initialization sequence. PASSON olaces a connection in a state of 
waiting for an FC/INIT/R (after a CON/REQ/N) or an FC/INIT/N 
(after an FC/INIT/R)* In this case the connection Is not in the 
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wait state when the FC/HIT/R or FC/IHIT/N is received. The 
message is ignored (which will hang an uninitialized connection) 
and PASSON continues interactive processing after issuing the 
abnormal message* 

12. PASSON ABNORMAL 11 

PASSON has received a network- shutdown supervisory message 
(SHUT/INSO/R) from NAM indicating that NAM shutdown is in 
progress. PASSON terminates immediately if the shutdown is 
i mmedi ate* otherwise the shutdown message is relayed to NOS/VE and 
PASSON continues interactive processing after it issues the 
abnormal message. 

13. PASSON ABNORMAL 12 

A supervisory message has been received by PASSON from NAN that is 
not in the list of supervisory messages which PASSON can recognize 
and receive from NAM. The message is ignored* PASSON issues the 
abnormal message and continues interactive processing. 

14. PASSON ABNORMAL 13 

The status of PASSON is normal and processing continues. 

15. PASSON ABNORMAL 14 

The memory link reported a fatal error status when PASSON 
attempted to send a queued upline supervisory message to NOS/VE. 
The message is not sent and PASSON continues interactive 
processing after issuing the abnormal message. 

16. PASSON ABNORMAL 15 

The memory link reported a fatal error status when PASSON 
attempted to send an upline supervisory message to N0S/V£ that was 
not queued. The message is not sent and PASSON continues 
interactive processing after issuing the abnormal message. 

17. PASSON ABNORMAL 16 

PASSON tried to send a supervisory message from NAM to N0S/V£ but 
had to queue the message for later transmission* but there was no 
altocatable space to queue the uessage. The message is not sent 
and PASSON continues interactive orocessing after issuing the 
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abnormal message. 

18. PASSON ABNORMAL 17 

The memory link reported a fatal error status when PASSON 
attempted to send a queued upline data message to NOS/VE* The 
message is not sent and PASSON continues interactive processing 
after issuing the abnormal' message. 

19. PASSON ABNORMAL 18 

The memory link reported a fatal error status when PASSQN 
attempted to send an upline lata message to NOS/VE* The message 
is not sent and PASSON continues interactive processing after 
issuing the abnormal message* 

20. PASSQN ABNORMAL 19 

PASSON has received a connection-rejected supervisory message 
(CON/REQ/A) from NOS/VE for a connection which was not in the wait 
state for a CON/REQ/N. PASSON Places a connection in a state of 
waiting for a CON/REQ/N after the connection has sent a CON/REQ/R 
upline to NOS/VE. The connection is ended and PASSON continues 
interactive processing after issuing the abnormal message. 

21. PASSON ABNORMAL 20 

PASSON has received a connection accepted supervisory message 
(CON/REQ/N) from NOS/VE for a connection which was not in the wait 
state for a CON/REQ/N* PASSON places a connection in a state of 
waiting for a CON/REQ/N after the connection has sent a CON/REQ/R 
upline to NOS/VE. The connection is ended and PASSON continues 
interactive processing after issuing the abnormal message. 

22. PASSQN ABNORMAL 21 

PASSON has received a supervisory message from NOS/VE to stop 
interactive processing. PASSON terminates. 

23. PASSON ABNORMAL 22 

PASSON has received a supervisory message from NQS/VE which is not 
in the list of supervisory messages which PASSON recognizes and 
can receive from NOS/VE. The message is ignored and PASSON 
continues interactive processing after issuing the abnormal 
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message. 
24. PASSON ABNORMAL 23 
Not used* 

23* PASSON. ABNORMAL 24 

PASSON has received a data message from NAM whose message header 
has the ibu (input block undat iverable) bit set. The message is 
not sent to NQS/VE and PASSOM continutes Interactive processing 
after issuing the abnormal ' massages 

26. PASSON ABNORMAL 25 

PASSON has received a supervisory message from NAM whose message 
header has the i bu (input block andel iverable) bit set. The 
message is not sent to NOS/VE and PASSON continues interactive 
processing after issuing the abnormal message. 

27. PASSON ABNORMAL 26 

The memory link reported a fatal error status when PASSON 
attempted to send a message (data* supervisory* queued data or 
queued supervisory) to a MOS/VE application not signed on to the 
memory link. The message is not sent to NOS/VE and PASSON 
continues interactive processing after issuing the abnormal 
mess age. 

28. PASSON ABNORMAL 27 

PASSON has received ^n error-logical supervisory message 
(ERR/LGL/R) from NAM for a connection. The message is reported to 
the job dayfile for the connection and then relayed to the 
connection's associated NOS/VE application. After issuing the 
abnormal message PASSON continues interactive processing. 

3.10.2 MEMORY LINK FATAL ERROR CODES 

The fatal memory link error codes are listed below with corresponding 
descriptions. Those error codas oot listed are not fatal errors. 

1. MEMORY LINK FATAL ERROR 1 

This status value indicates that the application name of the 
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receiver is not valid. Currently* the only invalid value is -1. 
The request is ignored. 

2. MEMORY LINK FATAL ERROR Z 

This status value indicates that the application name of the 
sender is not valid. Currently* the only invalid value is -1 • 
The request is ignored* 

3. MEMORY LINK FATAL ERROR 3 

This status value indicates that the receiver application is not 
currently signed on to ML I. The request is ignored* 

4. MEMORY LINK FATAL ERROR 4 

This status value indicates that the application name specified is 
signed on to MLI* but by a different task than the one making the 
request* i*e.* the requesting task is not the •owner' of the 
application. The request is ignored* 

5. MEMORY LIHK FATAL ERROR 7 

This status value indicates that an ADD_S£NDER request is being 
performed* but the permit list of the receiver is full* The 
maximum number of permits is specified by m IcSmax.perml ts. The 
request is ignored. 

6. MEMORY LINK FATAL ERROR 9 

This status value indicates that the sender application being 
referenced is not currently signed on to MLI. The request is 
i gnor ed* 

7. MEMORY LINK FATAL ERROR 9 

This status value indicates that a SEND_MES$AGE is being attempted 
between two applications* both of which are C170 applications. 
The request is ignored. 

8. MEMORY LINK FATAL ERROR .10 

This status value indicates that the sender application has not 
been granted permission by the receiver application to sen4 
messages to it CCONFIRM.MESSAGE or SEND.MESSAGE request) or that a 
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D£LETE„S£ND£R ) request is being performed for an application not 
currently permitted. The request is ignored* 

9. MEMORY LINK FATAL ERROR 15 

This status value indicates that a RECEZVE.MESSAGE request has 
been made* but the buffer that is to receive the message text is 
smaller than the actual message* The request is completed 
normally* but only as much of the message is transferred as Mill 
fit In the buffer* 

10. MEMORY LINK FATAL ERROR 17 

This status value indicates that the length of the message 
specified in a SENO.HSSSAGE request is greater than 
mi c$max^message_l ength. The request is ignored. 

11. MEMORY LINK FATAL ERROR 21 

This status value indicates that the application has tried to 
SIGNJJN to HLI more than « f c$max_s i gnons_per_appl times. The 
request is ignored. 

12. MEMORY LINK FATAL ERROR 22 

This status value indicates that the max^messages parameter on a 
SIGN_GN request is larger than mi c$max_queued_messages. The 
request is ignored. 

13. MEMORY LINK FATAL ERROR 11 

This status value indicates that the maximum number of 
applications are currently signed on to MLI* The request is 
ignored. 

14. MEMORY LINK FATAL ERROR Zh 

This status value indicates that a SIGN_0N request has attempted, 
but the task making the request has already signed on 
ml c$max_si gnons_per_systen^nanie unique applications. The request 
is ignored. 

15. MEMORY LINK FATAL ERROR 25 
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This status value indicates that some sort of internal error has 
occurred within HLI. The request may be retried* but the results 
are unpredictable. 

16. MEMORY LINK FATAL ERROR 26 

This status value indicates that a C170 HLI request has specified 
an illegal HLI function* The request is ignored. 

17. MEMORY LINK FATAL ERROR 11 

This status value indicates that a C170 parameter passed to HLI by 
a C170 job «as invalid* This can be due to a parameter value out 
of range or because of an address beyond the C170 field length. 

18. MEMORY LINK FATAL ERROR 23 

This status value indicates that a memory link request was 
performed by a C17C job and that the NQS/VE system was not running 
at the time. The request is ignored. 

3.10.3 CONFIGURATION MANAGEMENT ERROR CODES 

The following Configuration Management error codes are not documented in 
the Diagnostic Message manual for Rl.1.2. 

1. Recorded vsn {text} contains more than 6 characters. 

Product Identifier? CI Condition: 350660 
Condition Identifier? C«E*CMD«NAME«TOGJLARG£ 

assaniaiiaai 

The recorded vsn entered contained more than 6 characters. 

y&£L_A££jUiU 

Reenter the command using a vsn of 6 or fewer characters, 

2. Channel number CtextJ is not in range between {text} and {text}* 

Product Identifiers ZA Condition: 350665 

Condition Identifier: C1SSILLEGAL.CHANNEL_NUHBER 

The channel currently being used by NQS/VE for access to the 
system device is not supported by NOS/VE. 
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U£££-Afi£iaQi 

Change the channel selected on the SETVE command to one supported 
by NQS/VE. Currently* HOS/VE supports channel numbers from 
through 27 <10). 

3. File CfHel must have page width of at least Ctextl characters. 

Product Identifiers C-i Condition? 350735 
Condition Identifier! CME$»Cy,ILLEGAL_OUTPUT_FILE 

The output file must have the specified minimum page aidth* 

Change the file attributes to have a page width of at least the 
spect fi ed si ze* 

4. Product identification Ctextl is unknown to the system. 

Product Identifiers 01 Conditions 350770 
Condition Ident if i er x CME4PCU.UNKN0WN.PR0DUCT.I0 

&£S££i2£iaaX 

The product identification specified is not currently supported. 

Ji&££-A&£ift&l 

Check the supported equipment and verify that you are using a 

supported product identifier. 

5. Unable to allocate the active volume table in procedure Ctextl. 

Product Identifiers CM Conditions 350602 
Condition Identifiers CME* PC. ALLOC ATE.AVT.ERROR 

ut£l££i2£iaui 

An active volume table for devices besides the system device can 

not be a 1 1 oca ted. 

U&££_A£ii20.i 

Redeadstart the system. If the condition persists* contact a site 

analyst. 

6. Logical unit Ctextl is not in the physical configuration table. 
Product Identifiers CI Conditions 350640 
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Condition Identifier! CHE*PC JJNIT.NOT.FOUNO 

The element described by the given logical unit number is not 
present* 

U&£L.A£iifi&i 
Retry the request. 

Included with NOS/VE standard products Is the Diagnostic Virtual 
System (DVS). OVS is a utility which controls on-line diagnostic 
test execution under NOS/VE* Programs used by DVS are enhanced 
versions of off-line diagnostics* These diagnostics employ the 
same testing strategy* but contain unique code for on-line 
inter f aci ng* 

Usage 

OVS documentation is available In the form of a printed usage 
guide* publications number &CH69 720 revision 8* It is also 
documented in an on-line yarsion of the usage guide. The on-line 
guide is contained on file DVSJJSAGE in the HARDHAREJ1AINTENANCE 
subcatalog. To use the guide enters 

EXPLAIN H*$SrSTEM.HARDW ARETHA I NTEMANCE*DVS.US AGE 

Notes and Cautions 
1* The DEBUG hardware test (3BUG)» although documented for release 
1»1.2# Hill not be released until 1.1.3* 

2. When using DVS with Dual Processor Cyber 830's* it is possible to 
create a situation where DVS obtains most of the CPU resource when 
a specific processor is selected for testing. It is recommended 
for concurrent operation* that you do not select a specific 
processor* 

3. tiherx using DVS with Cyber 845/855 systems* diagnostics BIHM and 
NUMR detect known 3DP end-case failures* Using 
RUhL.CPU_DIAGNaSTICS automatically detects the processor type and 
will not run these tests* However* when manually selecting tests* 
it is recommended that these tests not be run until the 
appropriate FCO's are installed* 
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4* vfhen using DVS with Cyber 845/855 systems* diagnostic RFST detects 
knoan 8DP end-case failures* $hen using the RUN_DVS coauaand* you 
should not alter the RFST_QEL£TS_BDP parameter. It is IHPARATIVE 
that this parameter regain at its default setting until 
appropriate FCO's are installed to correct the end-case failures. 
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* » 13££&AIIIifi.SX5I£l!-MQI£5-Alia-; AUIIQUS 



4.1 miE*L£Qai!AJi&-Uri£UAS£ 

1* A command that depends on the "oath name*' for a file is affected 
If the file has been explicitly attached (attach.f i I e* create^f i 1 e 
commands ) • 

The "path name" that sych a command Mi it encounter is the "local 
path name* 9 rather than the path specified when the command was 
called* For example* 

ATTACH_FILE SUSER.X LFN»Y 
REPLACE.FILE SUSER.X 

will result in a file called Y being referenced in real state 
rather than X. Users should not mix implicit and explicit use of 
a ft le. 
PSR NVOD753 

2. The SPRQGRAH function does not return the open position designator 
for the LQAQ_HAP f i I e. 

PSR NV0D483 

3. The SET.SEMSE. SWITCH (SETSS) command will not accept a "user 
supplied job name'* but will only work when given a "system 
supplied job name"* 

PSRs NV0D87U NV00888 

4. The constants $MIN_INT£G5R and $HAX_INTEGER have values of 
-(2**48-11 and 2**48-l# r esoect i ve 1 y * rather than -(2**63) and 
2**63-1. 

PSR NV0D609 

5* Any files created by the program interface cannot be displayed 
with DISC $L0CAL. For example* the default files created in 
FORTRAN do not appear when subsequently entering OISC $L0CAL. 
PSRs NVEA052j. NVEA055* NVEA036 

6. JOB/JOBEMD reformats data lines which end in two periods. The 
problem is that J08/J08END treats lines ending In two periods as 
command lines to be continued and writes the concatenated form of 
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the command line to the file it sub* its as a job. This is usually 

only a problem if the job contains a usage of CGLLECT_T£XT* In 

this case* the file could be created before using J0B/J0BEH0 and 

referenced in the job* rather than creating the file within the 

job* 

PSR NVGF327 

?• In the process of Implementing improvements to 
DISPLAY.CGMHAND.LIST* the command table passed to €LP$PU$H_UTILXTY 
by command utilities has been changed* 

The new tables should be produced by using the new command table 
generator which is described in APPENDIX D» 
GEMer ate_€ommand_Table does for the new command and function 
tables what the parameter descriptor table (PDT) generator does 
for PDTs. It takes as input a specification for the table and 
produces as output the CY3IL variable declarations that represent 
the table* 

CLP3PUSH_UTILITY expects entries in the tables it is passed to 
have b^ef\ correctly generated* unlike the previous situation in 
which you could pass a table that was unsorted or contained names 
in lower case letters* 

f4ew commands for displaying the command list have also been 
implemented* Thus the information that used to be available via 
the full mode option of the OISPLAY.COHMANO.LIST command must now 
be obtained from the 9ISPL4Y_CQH*!AN0_LIST_EtURY command. See the 
following section on "Additional Commands" for a description of 
the new form of the D ISPL.4Y_C0HMAHD.LIST command* and the new 
OISPLAY.COHMAND.LISTJENTRY command* 

8* Two parameters have been added to the COLLECT.TEXT command 
following the UNTIL parameter* 

prompt* pi This parameter specifies the prompt string to be issued 
for each line if collect. text is getting Its input from an 
interactive terminal*! If the null string is specified* no 
prompt is issued* 

Omission causes 'CT? 1 to be used* 

substi tut i on_mark# smt This parameter specifies a character that 
is used within the text to be collected to delimit text to be 
substituted* or that no such character be used (NONE)* 
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Corresponding pairs of substitution marks must appear on the 
saie line* The tsxt between such marks is evaluated as an 
SCL string expression* the result of which replaces the 
original text including the substitution marks. 

If the expression cannot be evaluated or its result cannot be 
converted to a string* the COLLECT_T£XT command terminates 
with an appropriate error. If no second substitution mark is 
found on a tine* the and-of-Hne is treated as the second 
substitution mark. If two consecutive substitution marks 
appear* they are replaced by a single substitution mark in 
the collected text. Substitution cannot be used to construct 
the line containing the termination string* i.e. the 
termination string is checked for prior to processing the 
line for substitution* 

Omission causes NONE to be used. 

3. A parameter has been added to the J08/J0BEMD command following the 
JQ8_CLA$S parameter. 

substi tuti on.mark* sat This parameter specifies a character that 
is used mi thin the statements to be collected to delimit text 
to be substituted* or that no such character be used (NONE). 
Corresponding p^irs of substitution marks must appear on the 
same line. The text between such marks is evaluated as an 
SCL string expression* the result of which replaces the 
original text including the substitution marks* 

This capability is orovided because the submitted job does 
not have access to any variables or procedure parameters of 
the job that initiates it. Therefore* if parametric 
information is to be used in the submitted job* it must be 
substituted directly into the statements of the job. 

If the expression cannot he evaluated or its result cannot be 
converted to a string* the J0B/J08EN0 command terminates with 
an appropriate error. If no second substitution mark is 
found on a line* the end-of-line is treated as the second 
substitution mark. If two consecutive substitution marks 
appear* they are replaced by a single substitution mark in 
the collected text* Substitution cannot be used to construct 
the JQSEND del i mi ter. 

Omission causes HONE to be used. 



SOFTWARE RELEASE BULLET!' 
NOS/Vs Rl.1.2 LEVEL 630 



4-4 
85/03/29 



4.0 OPERATING SVSTEH NOTES AND CAUTIONS 

4.1 SYSTEH COMMAND LANGUAGE 



10. Interactive Command Language Prompting 

This release includes the initial phase of interactive prompting* 
Subsequent releases Mill include a more comprehensive prompting 
facility with help modules containing messages and prompts for 
each command. 

For a command entered from an interactive terminal* SCL issues 
prompting information to the terminal depending upon user actions 
and the **mode" in which the user is operating. 

"NORMAL* MODE 

This is the mode under which all commands in procedures* batch 
jobs and included files are processed by default — that is* if 
any error is detected during evaluation of the parameters for the 
command* processing of the command is terminated immediately. 

"LINE" HOOE 

This mode is applicable only to Interactive jobs* Line mode must 
be explicitly selected by the user via the S€T_C0MMAND_M0D£ 
command. 

This mode does not require any special type of terminal but does 
take into account certain terminal attributes such as page width. 

In line mode., the parameters entered with the command name are 
evaluated and for each detectable error* an error message is 
written and the user is promoted to enter the correction. The 
prompting information is derived from the data in the command's 
parameter description table {POT). 

Once ail specified parameters have been accepted* a check is made 
to insure that all required oarameters have been supplied and if 
not* the user is prompted to enter them. 

When entering corrections or omitted parameters* the user may 
enter more than the parameter being prompted for. This is done in 
exactly the same nay as parameters are normally given to a 
command. 

If the original call to trie command did not include any parameters 
and the command has at least one required parameter* the user is 
prompted for each parameter of the command* except those with the 



4-5 

SOFTWARE RELEASE BULLETIN 

85/03/29 
HOS/VE Rl.1,2 LEVEL 630 



4.0 OPERATING SYSTEM NOTES AND CAUTIONS 

4.1 SYSTEH COMMAND LANGUAGE 

VAR attribute that are optional (this includes the STATUS 
parameter I • 

In response to any prompt* a terminate break can be entered to 
terminate processing of the command* Also* a question mark (?) 
can be entered to obtain information about acceptable responses to 
the prompt* If a question- mark is entered twice in succession in 
response to a prompt* or a double question mark (??) is 'entered* 
information about how to use line mode facilities is displayed* 

4,1.1 ADDITIONAL COHHANOS (HOT IN MANUALS) 
4.1*1.1 m£UX-£DMM£-£4EAmEEm-iai££El 

This command displays information about the parameters for a command* 
The information includes the names of the parameters* their types 
(including allowed keyword values) and their default values (or an 
indication that the parameter is required)* 

This command is not intended to be a replacement for information in 
online manuals* but rather a **menory joaoer** for any command. It will 
work for any command that could be called at the point where this 
command is called (including system supplied commands* SCL procedures* 
user programs and utility subcommands ) « 

This command can be used to obtain information about the parameters 
for any command that uses SCL services to parse its parameters* 

disp I ay. co mm and., parameters comman1*<coiir!iand> 
Coutput*<f i I e referenced 
£status aB <status variable>3 

command ? c* This parameter specifies the command for which information 
about parameters is sought* 

output « oi This parameter specifies the file to which the parameter 
information is written* OiHssion will cause SQUTPUT to be used. 

status* This is the standard status oarameter. 
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This command displays the names of trie entries in and/or the search mode 
governing the command list. 

di sp I ay.command.. I i st tdi splay.op tions* ! i st of all * 
entr i es * entry " e * searsh.mode* sm] 
£output*<f i I e referenced 
£status*<status variable>] 

di splay.options * disp I ay_opti on J dot This parameter selects the 
information to be displayed* 

alls This option selects all of the other options. 

entries I entry * ei This option causes the names of the entries in 
the command list to be displayed. 

search_mode J sm: This option causes the command list search mode 
to be displayed. 

Omission causes entries to be selected* 

output 1 oJ This parameter designates the file to which the information 
is written. 

Omission causes Soutput to be used* 

status? This is the standard status parameter. 

4.1.1.3 JJIS£LAl-£Q!l!lil4ft-LI5I-£liISiri£Sl-iai&fiL£l 

This command displays information about one or more command list 
entries* 

di sp I ay_command_l ist_entry Centry»Hst of <f I I e> J all J 

control _st at ementsJcontro I _stat ementJcs « 

first, f] 
Cdispl ay^options-l i st of all * al I .names* al I name * an J 

commands « command J c \ f unctions? functi on J f 

names* name JnJ 
£output»<f i I e referenced 
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£s tatus*<status var i ab 1 a>] 



entry » entries ♦ et This parameter selects the command list entry or 
entries to be displayed* Any entry that can be put in the command 
list can be selected regardless of whether it is presently in the 
command list. In addition the following keywords can be used to 
make generic selections* 

alls This option selects the entire command list for display {this 
includes the control statements). 

control.sta tements J control .statement J ess This option selects 
the control statements and commands inherently part of SCL. 

first I fs This option selects the first entry in the command list* 
This provides a way of selecting a display of the subcommands 
supplied by a utility when the utility is active. 

Omission causes first to be used. 

di spl ay.options J di spl ay_option \ dot This parameter selects the form 
and content of the output* 

all: This option selects ail of the other options. 

al l_names 1 all_name * an s This option causes all of the names 
(abbreviations and aliases* as well as the "nominal 1 * names) of 
commands and/or functions and/or control statements to be 
di spl ayed* 

commands \ command J ct This option causes information about the 
individual commands within the selected command list entries 
(other than catalogs) to be displayed. 

functions J function * fi This option causes information about the 
individual functions within the selected command list entries 
to be displayed. 

names J name « ni This option causes the ••nominal" names of 
commands and/or functions and/or control statements to be 
displayed* A "nominal" name is the name by which the command* 
function or statement is normally known* 

Omission of this parameter causes commands and names to be 
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selected* Omission of both commands and functions causes commands 
to be selected* 

output J os This parameter designates the file to which the information 
is written* 

Omission causes Sou t put to be used* 

status* This is the standard status parameter* 

4.1.1.4 S£I_a£EAULI-EAaiULIS£I!i&i 

This command provides the operator with the capability of establishing a 
default family for jobs* Tils command affects ail jobs except those 
initiated via the JOB/JOBEND coimand. This includes jobs RQUTEd from 
the NOS system* 

NOTE that prior to the availability of this command* jobs submitted via 
the SU3MIT_J08 command would have defaulted the family to that of the 
submitter — this is no longer true. 

If this command is never issued* the default family name is SSYSTEN* 



set.def aul t_f ami ly f ami I y < _nawe*<name> 
Cstatus*<status variable>] 



f ami I y. name J fns This Parameter specifies the name to be used as the 
default value for the family_name parameter of the LOGIN command. 

status: This is the standard status parameter. 

4.1.1*5 1£I JLOMAHIL.a£&l-iS£mi 

This command determines how subsequent commands entered from a terminal 
will be handled in the event of incomplete or incorrect parameters* 



set.coM an demode mode*! ine? I 5 nor ma I « n 
status 



mode* m* This parameter specifies the command mode being selected* 
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status? See ERROR HANDLING* 

4 • X . l • 6 CaASSLJiAiy&AL-].AJi£!iAS£-i£yA&Li 

This command determines the oref erred natural language to fee used for 
iessagesi help Information* etc. 

change.natural.l anguage* chanl ( 

natural.! angyage* n I s any of 
key 

dani sh 
dutch 
e n g I ish 
flnnish 
french 
german 
i tal t an 
norwegian 
Portuguese 
span ish 
sued ish 
us.engl I sh 
keyend 
name 
any end * Srequired 
status) 

natur al_l anguagei this parameter specifies the natural language being 
selected. 

status: See ERROR HANDLING. 

4.1.2 ADDITIONAL FUNCTIONS (NOT IN MANUALS) 

4.1.2.1 iaflaHAI4fll-iQU&££ 

This function is used to determine where the processor for the 
requesting command was found. The source (file or catalog) of the 
command is returned as a string. i 

By its nature* this function is not particularly useful wnen used in 

the expression for a parameter to a command* since* in that case* it 

will return the source of that command. Therefore* this function is 
normally used in an assignment statement. 
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<$command_source> 85* $COPmANO - .S[)iJRCS C<C> <)>3 

Example* "The foil owing proc resides on an" 
"object library in some catalog*" 
PROC sampl e^command 

cs * $command.source 

cat * $patM $fname<cs )» catalog! 

"The following command executes file" 

"s amp I e_progr am in the sane catalog** 

execute_task $fname(c at //' .samp I e.progr am* ) 
PROCENO 

4.1.2.2 l£&£3iIQy5-SIAiyS 

This function is used to obtain the caupletion status of the previous 
command. 

<$previotis.statu5> tt- SPREVIOUS.STATUS C<(> <)>3 

Example* collect_text displ ay.status 

PRQC di sp I ay_s tat us» diss t 

status: status » $pr evi ous.status) 
di spl ay_val ue $val ue( status ) 
PRQCEND display.status 

create_var I abl e s kind- status 

create_var i abl e x status's 

di spl ay_status 

NORMAL STATUS 

create.var i abl e x status»s 

displ ay.status 

— ERROR*- X is already declared as a variable* 

Mais 8 there are certain status conditions that do not cause 
$PREVIOUS_STATUS to return the expected value* Among these are error 
from control or assignment statement and "xxx is not a command*** 
PSR NV0F077 

4.1.2.3 1£U0I£ 

This function Is used to quote a string. 
<$guote> tt* SQUOTE <<> <string exor> <)> 
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Example* s ■ 'ASC'DEF' 
q s $<|UOte<s) 
d i so i ay_y al ue s 

^BC'DEr 

d ispl ay_yal ye q 

'ABC"0£F» 



4.1. 2,4 M£M_MX 

This function is used to search a string for any one of a set of 
characters and return the index in the string of the found character* 
If no character from the set appears in the string* zero is returned* 

<$sca«_any> it* $SCAN_ANY <<> <char set> < 9 \sp> 

<stMng expr> <)> 

<char set> *i = <strtng e%pr> 

Example! digits * '0123456789' 
s ■ •TEHP.32 1 
di sp I ay_v at ue $scan_any (di gi ts» s) 

6 

4.1.2.3 MSLM-MQI-AM 

This function is used to search a string for any character that is not 
in a set of characters and return the index in the string of the found 
character. If only characters from the set appear in the string* zero 
is returned. 

<$scan_not_any> *t» $SCAN_NQT_ANY <<> <char set> <*Jsp> 

Cstring e%pr> <)> 

<char set> Jt» Cstring expr> 

Example* digits * '0123456789' 
s * «TEMP_32' 

displ ay.vai ue $scan.not_any ( di gi ts* s) 
1 
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4.1.2.6 iSCAi!-lI&I!lfi 

This function is used to search a string for another string* called the 
pattern* and return the index of the first character of the pattern in 
the string. If the pattern is the null- stringy a value of one(l) is 
returned. If the pattern is not found in the string* a value of zero 
CO) is returned. 

<$scan_str ing> :** $SCAN_STRINS <{> <pattern> <*lsp> 

Cstring expr> <)> 

<pattern> n* <string expr> 

Example! s » »123_abc_9» 
p * » abc» 
d isp I ay_val ue $scan_str'ina(p» s) 

5 

4.1.2.7 H&M£UI£ 

This function is used to change characters in a string according to a 
translation table. The translation table is a string of 23b characters 
which is utilized according to the following algorithm. 

result * »» 

for i * 1 to $str len<sfcr i nq\ do 
j « SordC $suhstr(stri ng» \)) 

result * result // fcsubstr C t ahl e* j+1) 
f orend 

Two standard translation tables are provided. Use of L0WER_T0_UPPER 
(LTU) produces a string with alt lower case letters translated to their 
upper case counterparts. Use of UPP^R.TQ.LOWER <UTL) produces a string 
with all upper case letters translated to their lower case counterparts* 

<$translate> is* $TR4NSLAT£ <<> translation table> <>\sp> 

<strincj exor> <)> 

translation tabie> u* <string exvr> 

\ LOWERjn.UPPER ? LTU 
! UPPER.T9.L3WSR J UTL 

Example! d ispl ay.val ue $tr ansl ateC I ower„to_upper# l 123„abc , J 
123.A8C 
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4.1.2.8 iiaia 

This function is used to remove trailing space characters from a string* 

<Strisi> »*« $TRIH <<> <string e*pr> <)> 

Example i s * 'STRING » 

d i sp I ay.value •< | //s//*> f 

<STRING > 

displ ay.val ue * <*//$tr i mis) //•>* 

<STRING> 

4.1.3 ADDITIONAL CONTROL STATEMENTS <N1T IN MANUALS) 
4.1.3.1 EUStLCQttttAtiaS 

<push commands> * t» PUSH.CQHMANDS 

The purpose of this statement is to cause the source I f j I e or catalog) 
of the issuing command to be pushed onto the top of the "dynamic command 
list". The entries in the dynamic command list are searched after the 
commands belonging to any active utilities and before the command list 
entries manipulated by the SiT.Cf3HHAND.LIST command. The effect of this 
statement is removed (popped) when the issuing command terminates. 

4.1.4 ADDITION CY8IL PROGRAH INTERFACES (NOT IN MANUALS) 

4.1.4.1 Aa£!&££UC£-£E£JttQi!3-E££Q&2 

The purpose of this request is to replace an entire record. This 
request is valid only for vass storage files opened for sequential 
record access* The file position must be at the end of the record to be 
replaced. The file position remains at the end of the record replaced. 
The length of the replacement record must be identical to the length of 
the previous record for a file whose record-type is CDC-variable (V). 
Note the length of the previous record is exclusive of V r ecord-headers» 
i.e. only the logical length of the records must be identical* 
Therefore* a record output with a series of partial PUTs can be 
replaced. For a file whose record-type is ANSI-fixed (F)# the 

replacement record will be truncated to max i mum-r ecor d-l ength* if the 
replacement record exceeds maxi mum-record-i ength. The length of the 
replacement record must be lass than or equal to the 

maximum-bl ock-l ength for a file whose record-type is undefined (Ul and 
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vthose block-type Is user-specified. Note that a record deleted by an 
aiapSdelete. previous. record request cannot be replaced because one cannot 
position to the end of a deleted record. This request is not supported 
for a file whose record-type is undefined I U I and whose block-type is 
system-spec! f i ed. 

This request requires 'modify* access to the file. 

FORMAT* 

A«P$REPLAC£_PREVIQUS_R£C3RD (FILE IDENTIFIER, 

irfORKING.STORAGE.AREA, WORKING. STDRAGE.LENGTH, STATUS) 

FILE. IDENTIFIER* (input) This parameter specifies the file access 
identifier established when the file *as opened. 

WQRKING.STQRAGE.AREAi (input) This parameter specifies the address of 
the record **hich is to replace an existing record of the file. 

WORKING.STQRAGE.LENGTH* (input) This parameter specifies the length 
of the record to be output. 

STATUS* (output) This parameter specifies the request status. 

condition identifiers! 

ame$r ing.val i dat i oh. error, 
ameli mproper.fi I e. i d, 
ame$i mproper. access. attempt » 
ame$i mproper.ws l.val ue, 
aroe$i iupro per.fi I e.posi t §on> 
aroeSunrecovered.Nir i te_error » 
ame$f i le.organi zat ion.conf I let* 
ameSi mproper.device.class* 
ame$conf I ic ting. ace ess. I eve I » 
ameSr ecor d. exceeds. mb l» 
aipe$record. unequal. to.preyi oust 
ameSunsupported.operati on; 

procedure declaration! 

PROCEDURE CXREF] aropSreP I ace.nr ev i ous.r ecord ( f i I e.i dent i f i er * 
asit$fi I e.i dent if ier; 
working.storage.ar ea» A celi; 

viorking.stor age. I ength* amtSworki ng.stor age. I engths 
VAR status* ostSstatusM 
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?? PUSH aiSTEXT J* OH) H 

*copyc AMTSFILE. IDENTIFIER 

*copyc ANT$WORKING_STQRAGE_IENGTH 

*copyc QSTiSTATUS 

*copyc ANCSCONDITIQN.COOE.LI^ITS 

*copyc AHE$CGMFLI€TING_AC€ES$_L€VEL 

*copyc AHE$IHPRQPER_FIL£_IO 

*copyc AMESPUT.VALIDATiaN.ERRORS 

*copyc AHESTfRMINAL.VALIOArinM.cRRQRS 

*copyc AMESRING.VALIDATION.SRRQRS 

*copyc AMESIWPRQPER.WSt 

*copyc AWE $ PUT. PROGRAM. ACTIONS 

?? POP ?? 

4.2 EEQMAILMMSI8EMI 

1. Loading files into multiple rings may cause improper ring 
attributes to be assigned* 

PSR NV0C789 

2. The load tine for large programs is too high* 

Solutions Pre-Jinked object nodules. 

Large programs take a long timed to load. Analysis shots the 
loader spending much of its time building addresses in static data 
sections. This is especially true in large FORTRAN programs. 

A process of w Pr e-l ink i ng»* has been created to completely 
eliminate the time spent in the loader building static addresses. 
A bound program and its destination ring brackets are given to the 
virtual environment linker CLINVE) which pre-links the product 
using a set of reserved segment numbers. AH addresses in static 
data sections are built and stored with the static data for the 
section. This data can be sinply copied at load time into Its 
reserved segment. 

The output of the linker is a single object module which can be 
placed on an object library and/or executed. The Object Code 
Utilities handle this -new module as it would any other object 
module. All QCU commands may be used with a "pre-l inked" module. 
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/ 

/ I ink_vl rtuai_envi ronment 

V£L/set_i ink.options «ode»PROOUCT 

VEL/add.obJect.fi ie f i le-BQUNO.PRQDUCT r ing.br ackets* C IU 11*11) 

VEL/generate.yirtual.aemor'V vl rtual „image»PREJLINKED_PRODUCT 

VEL/gui t 

/ 

/create.ob ject. I i br ary 

€QL/add..module I ibrar yPRE.HNKEO.PRODUCT 

COL/generate.i Ibrary I ibr ary-PRODUCT.LIBRARY 

CQL/quit 

/ 

/execute.task sp = PR0DUCT_.OTRY_PQINT f ! le»PRE_LINKED_PRODUCT 

/execute.task sp-PRODUCTJENTRY_PQINT I i bra ry«PRQDUCT J. IBRARY 

/ 

Care must be used when bui Iding programs that are made up of 
multiple w pre-l inked* f modules. Ail pre-defined segment numbers 
must be unique for the entire load sequence. The STARTING.SEGHENT 
parameter on the linker command S£T_LINK_0PTI0NS can be used to 
specify the first reserved segment number for a module. This 
parameter allows modules that have been M pre-I inked* separately to 
be used together at execution time. By default* the first 
reserved segment number is currently 36. 

The operating system reserves segments 36 to 63 for W pre-H nked H 
products. Each product must fit into these segments* Linker 
directives can be used to collect sections with similar attributes 
into one segment to reduce the total number of segments. 

*fi th the current impl ement at i on» sporatic initialization of 
read/write data will increase both file space and load time* 
During the coding and binding of a program* efforts should be made 
to collect all initialized data together near the beginning of a 

segment. 

A warning diagnostic is issued if the linker finds a text imbedded 
library that has not been specified on a US£_08jeCT_LIBRARY 
command. This warning cai be ignored and the loader will attempt 
to satisfy them at load time. 

A map is generated by the tinker containing diagnostics and 
information on how the program was H pre-I inked". The default file 
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name for the link map is SLOCAL.LXNKMAP. 

With the current implementation* only one module should be 
M pre~i i nked**. A program should be bound into a single module and 
then "pre- 1 inked**. 

The process of "pr e-l inking" programs can significantly reduce the 
time spent loading products* w Pr e-l inki ng w one of the system 
products resulted in a 35-43 percent reduction In page faults* CP 
time* and elapsed time during loading. The reduction should be 
even greater when loading large FORTRAN products. 

4 . 3 EtHilC Ak-UQ-1IA££I 

1. Tape usage is restricted to permanent file backup/restore and dump 
analyzer operations for Rl.1.2. 

*.* &a&ijl.a£££&j*ex!io& 

1. The SET.WQRKING.CATALOG (SETWCI command has no effect upon files 
whose names are created within applications. For examples 

SETWC .jxt 
execute_task 

task generates file name a 

Files created by programs are dot subject to the working catalog. 
The program should specify a complete path name. Files referenced 
as parameters of commands (i»e«» files specified at command level) 
will end up using working catalogs. 
PSR NVEA027 

2. Although the preset.value file attribute can be set bye the 
set.fi I e.attri bute command? this feature tis not supported. New 
pages assigned to segment access files are always initialized to 
zero. 

PSR NV0B204 

3. File attribute HIN_RECORDJ.ENGTH is not set properly for 
record.type F files. MIN_RECORD_LENGTH should default to 
MAX.RECQRDJ.ENGTH if it is allowed to default* but It is currently 
defaulting to 0. This affects SORT/MERGE when the sort key is 
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omitted and the default is taken. The user should explicitly set 
m\ n_record_i ength * max,jrecord_l ength* 
PSR NV0D398 

4. Skipping forwar d/feackwar d by records and partitions does not 
always report the encounter of boundary conditions with the 
correct exception condition* 

PSR NV00424 

5. If a FAP returns abnormal status to AHP$QP£N during an OPEN InenJi 
then BAH still creates the local file* In simpler terms* a user 
who faakes a mistake in the initial OPEN of an indexed sequential 
file Mill receive a proper diagnostic* but 8AH wrongly goes ahead 
and creates the local file anyway* 

PSR NV0E150 

6* File attributes that can be changed cannot be reassigned a NIL 
value* 

PSR NVEA0O3 

?* The SET..FILE.ATTRI8UTE command for an existing file accepts the 
specification of a preserved attribute even if it conflicts with 
the present one. No error will be seen and the preserved 
attribute will not be changed* Use DISPLAY.FILE.ATTRISUTES to 
verify attributes were set. Also* a subset of preserved 
attributes may be changed with the CHANGE_FILE_ATTRIBUTE command* 
PSRs NV0C839* NV0D617* NV3Q549, NV00536 

8* CQPY_FILE does not detect a coov of a file to itself via circular 
file connections. 
PSR NVEA118 

9. Files implicitly attached are not implicitly detached. 
PSRs NV0E322* NV0E296 

10* Attributes in the NOS/VE file label cannot be altered after 
creation* This could affect some migrating applications using 
indexed sequential files because FILE.LIMIT could be updated on 
C170 but not on C180. 
PSR NVEA034 

11. If a file has a f i I e-access-orocedur e (FAP) associated with it* 
the file can not be accessed from within the job monitor task. If 
this is attempted* a message will report the inability to load the 
FAP frost the library list. To get around the problem* enter a 
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utility environment of your choice and then access the file* As 
an example* if you do a C0P*_FIL5 involving an indexed sequential 
file and the error "unable to load FAP • ••** occurs* then you have 
just experienced this problem* 
PSR NW0C941 

12. If a file was created by CQLLECT.TEXT at NOS/Vt 1.1.1* it was 
created with file content » legible and line number « iQp 01 
(length and location). Under 1.1.2* if you attempt to copy this 
file to another file which does not yet exist* the copy aborts 
with AM 160044 - line number length and location are unequal, 
Note that it is impossible to create these files under 1.1.2 since 
(0 0) are out of range values for line number and the default is 
U 1). 
PSR NV00521 

1. The length of large data segments and files cannot exceed 

100*000*000 bytes. 

4.6 iai£&AttIJl£ 

1. If an output line for a display type terminal <CRTI is exactly 
equal to the page width attribute* overprinting of the line will 
occur if more output lines follow. To remedy this* set the page 
width differently or set the ou tput_devi ce attribute COD) to 

pr inter • 

2. Users are now able to inform, the OS of their terminal model by 
using SETTA's terminal .model (TR*1> parameter and specifying a 1-25 
character name. This attribute can only be changed by SETTA but 
can be retrieved by IFP$F£TCH_TERHINAL* 
IFP$GF.T_TeRMINAL_ATTRI8UTES* IF P$GET_D£FLT_TERMINAL. ATTRIBUTES and 
can be displayed by DISTA. The login defaults for this attribute 
are »CDC721» for terminal class 3* •VT100' for terminal class 7* 
and the null name for all other terminal classes. The 
restrictions which define valid SCL names are the only 
restrictions for specifying the term! nal_model parameter. 

3. A new error code has been added to Interactive Facility's 
repetoire to indicate that a task has aborted a get operation 
because an interactive condition was received. 

IFE*A80RT_GET — ERROR— get operation aborted because 
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interactive condition received 



4.7 ££&HAHfiiI-£ik£-i2IILIII£S 



A new function *BACKUP.:FILS . is available under the 

r estore.permanent.f i les utility* The purpose of this function is 
to interrogate the information on a backup. file produced by the 
backup.permanent.f i I e utility. All characters returned in the 
string are in upper case. The Shackup.f i I e function causes the 
backup file to be rewound* so only the first item on the backup 
file may be queried. 

$SACKUP_FIL£<<fi I e> <attribute>) 

The file parameter specifies the backup file to <suery. 

attribute result 



IDENTIFIER strin 



IDEMTIFIER..TYPE 

string 



Returns the oath name of the first item 

on the backup file. 

This is the default attribute* 

Returns the type of the item. Either* 
•SET* •CATALOG* 'FILE 1 or •CYCLE* 
is returned. 



Currently no abbreviations are supported for either 
Or for the attribute keywords. 



the function 



An example use for this function is in attempting to restore from 
a backup file for which the nine of the catalog or file backed up 
is not known* but the destination of the restore is known. Note 
that the value returned is a string? so that Sfname needs to be 
used to convert this to a file name* if this is to be used as a 
parameter on the restore.catal og or restore_.fi le subcommands. 

Examples 

Suppose someone has sent you a backup tape produced by a single 

8ACKUP.C ATALQG command, and that you want to restore the catalog 

to your own catalog SUSER .ilY.CATALOG. You could do the following: 

res to reaper manent.fi les I *1 I st.f 1 1 e 

restor e.cataiog $f name ($backup_f I I eibackup.f U e* identi f i er ) ) •• 

bf*backup_fi le ncn s $user .^y.cata I og 
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qui t 
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5.0 £&aau£i-S£i-aai£S-AajL£AuuQ!!S 

1* When. using DEBUG to breakpoint on a multi-line statement* the line 
number supplied to OgSJG must be the last line number of the 
statement* 
PSR CILA498 

2. Run- time error messages* such as RANGE ERROR* do not display the 
bad value* 

PSR CILA575 

3* If binary maintenance is required* the CCM parameter must be 
specified as $SYST£!1.C0HH3N.!1AI^TENANC€«GLD_UNB0UND_CCtt* This CCH 
interface will be updated for Release 1*1*3* 

4* The largest negative intager value causes STRINGREP to abort with 
arithmetic overflow* 

PSR CXLA838 

5. It is not possible to share data variables between CY8IL and 
another language (say FORTRAN** because CY8IL does not have any 
mechanism to create a con* on block* 

6* Static initialization treats integers as 60 bits instead of 64 
bits* 
PSR CILA880 

7* The RUNTIHE.CHECKS parameter is not accepted by the CY8IL 
compiler* Currently* the CY3IL conoller looks for RUNTIME CHECK 
(no »S»)* 
PSR CIL0005 

8* Tag checking does not work* 
PSR CILA886 

9* Using a null string iiside an inline procedure gives a length 
mi smatch* 
PSR CILA969 

10* Using un imp I emented features may cause CYSIL to abort with CGI 
error 38« 
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5.1 CY8IL 



?$R CILA679 

5.2 £MOL 

1. A deficiency in the COBOL/ DE3UG i m?\ ementat i on does not alio** the 
NODULE and PROCEDURE parameter names to contain hyphens when 
specified by the user* This problem can be avoided by omitting 
hyphens in the PROGRAM*-!:) name in the COBOL source program or by 
relying on the default values for MODULE and PROCEDURE when using 
the DISPLAY_PRGGRAj*i_VALUE, CHAHGE_PROGRAH_VALU£ and SET.8REAK 
commands. CDISPLAY.HEMQRY does not support default HQDULE names.) 
CQ80L data_names may contain hyphens* however* when specified as 
the NAME parameter of the DISPLAY^PROGRAH.VALUE and 
CHANGE.PROGRAN. VALUE commands . : 

PSRs NVGF043* D88A054 

2. The KEY TYPE attribute cannot be overridden any more. 
PSR CB8A431 

3. The utility routine CBP*S£T_FILE_ATTRIBUTES has been deleted. 
File attributes can be set in the COBOL program by doing ENTER 
M CL?$SCAN„CaMlUND_LIN£" using "SETFA. . . .♦♦* STATUS. The COBOL 
usage guide contains an example of the CLP$SCAN_C0?1HAND_LIN£ 
routine* 

4. COBOL cannot replace data items referenced by indices in the 
"INSPECT ... REPLACE" statement. 

PSR CB8A537 

5. When compiling with a wording catalog set* and the compile file 
contains COPY statements* the reference decks are not expanded. 
PSR CB80006 

1. Do not use the file name INPUT in batch mode. It is always a null 
(empty) file with no data in it. Choose a different name. This 
affects migration of jobs from NOS* where the name INPUT was the 
job's input deck. On NOS/VE use the COLL£CT_T£XT command to 
create the input data. 

2* When using FHU and inside Interstate Communication Facility* do 
not do a CLEAR on the EXSCUTE.TNTERSTATE COHHAND. This will clear 
the FASLAVE procedure file and render CREIC inoperable. 
PSR HV0F516 
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3. The ICF connection will tee terminated without any indication 
U»e*# diagnostic or informational message) if an FNU job aborts 
within ICF* This occurs in batch jobs only. 

PSR NVQF320 

4. When using VAX migration commands {€R£ATE.VAX.R£QU£ST# 
DISPLAY.VAX.REQUEST. DELETE. VAX. REQUEST) > it is r ecoiamen ded that 
parameter specification be limited exclusively to keyword 
specification to alto* for the addition of new parameters in a 
subsequent release* 

1. A job using an indexed sequential file may fail due to entry point 
errors from the loader. 

The following command executed earlier in the job wilt correct 
this* 

SET.PRQGRAN. ATTRIBUTES TERHINATIQN.ERROR.LEVEL-FATAL 
or SETPA TEL»F 

PSR NV0E276 

2. When the FILE. LIMIT attribute is set too small for accommodating 
all updates or inserts* the user runs the risk of the access 
method aborting with an error AAESFILE.AT.FXLE.LIHXT. In this 
case* the file is destroyed. 

PSR AA8A380 

3. All of the XREF decks relevant to indexed. sequent i al file usage 
should be in one base library. At present* some of them are in 
SSYSTEfi.COMHOH.PSFSEXTERNAL.IHTERFACE.SQURCE and some of them are 
in SSYSTEH.CYBIL.OSfSPRQGIUHL'INTERFACE. 

PSR NV0F197 

4. The XREF deck AHP$GET.KEY.:OEFINITIQMS forgets to copy in type 
declaration AHT$aPTIONAL.<EY.ATTRIBt}T£S. The workaround is to use 
ARRAY Cl«.nJ of AHT$0PTI0N AL. KEY. ATTRIBUTE. 

PSR NV0F938 

5. The GET routine does not honor $<EY. RELATION nor update the value 
in $PRMARY.KEY.ADDR£SS. 

PSRs AA8A377 



SOFTWARE RELEASE BULLETI! 
HQS/VE Rl.1.2 LEVEL 630 



5-4 
85/03/29 



5.0 PRODUCT SET NOTES AND CAUTIONS 
5.4 ADVANCED ACCESS METHODS 



6. COPY. KEYED. FILE aborts when copying any empty file* 
PSR AA8A357 

7» CGPY.KEYED.FILE specifying output to a terminal causes the first 
character of each fine to be lost, 
PSR AA8A353 

8* COPY.KE YED.FILE aborts when copying a file containing a 
nonstandard collated key? the message is "CAN'T LOAD COLLATING 
TABLE". 
PSR AA8A338 

5 . 5 SQU&CE-Mafi-UIILU* 

1. A CY8IL range error occurs at line 4747 of 
SCHSCQNVERT.UPDATg.TO.SCU.' 

PSR SC8A130 

The workaround is to take out the LIST parameter. 

2. A new source library format has been implemented to support 
present and future performance improvements. This will require 
conversion of existing libraries with the command that follows* 

This command reads an SCU source library in 1.0 format and writes 
it in 1.1 format. There is no procedure to convert 1.1 back to 
1.0. 

convert. scuIO. to. scull, C3NS10TQS11 tbase»<f i I e>3 
Cresult*<f 1 1 e>3 
tstatus-<status.variabls>1 

base { b This is the name of a file containing an SCU 

source. I i brary in the 1.3 library format. If this parameter 

is omitted an attempt is made to access a file named 
SOURCE. LIBRARY. 

result ' r s This is the name of the file to receive the converted 
library in version 1.1 format. If this parmeter is omitted 
the library will be written on file SOURCE. LIBRARY. SNSXT. 

status * Status variable. 

3. tfi th the new library format the lists of features* groups and 
modifications for a library will be maintained in alphabetic 
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sequence. The list of modifications and groups associated with 
decks will be kept in the sane order as previously used. In 
connection i«rth this change the di spi ay.opt ion parameter has been 
changed on the di spl ay.mod i f i cat i on.l i st command* 

di sp i ay.no d i f i cati on.l i st toutout«<f i I e.ref erence>3 
Cdi spl ay.opt ions* alph abet i c? chronol ogl cal 3 
ts tatus s <status_var i abt e>3 

output I o « This is the nave of the file which receives the 
display. Default is SOUT^UT. 

di sp J ay. options I disp I ay.opt i on * dio t If this parameter is given 
the keyword value CHRONOLOGICAL or C* modifications will be 
order by date and time of modification with the least recent 
first. If this parameter is omitted or value ALPHABETIC or A 
the order will be alphabetic* 

status J Status variable. 

This command displays a list of all the modifications for a source 
I i br ary. 

%. The deck. descr ipt ion parameter on the create. deck and change.deck 
coaamnds* the I ibr ary.descr lot i on parameter on the create.! I brary 
and change.! i br ary commands and the modi fi cat I on_descri ption 
parameter on the cr eata.mod i f i cat i on and change.modi f ication 
commands all accent as their values a list of strings* The 
corresponding $deck.header ♦ $1 i brary. header and 

Smodi fi cat ion. header functions have been modified to return an 
array of strings as the value for the description fields when it 
is appropriate. 

3.6 £aflai£I-S£I-=J2£fllifi 

1. w*hen an unselected event occurs in a ring lower than the ring in 
which It is running* DEBUS incorrectly informs the user that the 
error occurred in the procedure which called the faulty procedure 
in the lower ring. 

PSR DB8A098 

2. DEBUG and CYBIL do not have a run-time interface. Therefore* a 
program which aborts due to "CYBIL run time error** cannot be 
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3. 



properly trapped by DESUG.i Instead* the DEBUG trap occurs in the 
CY8IL error processor. To reference variables in the failing 
procedure* HODULE and PROCEDURE parameters need to be explicitly 
specified. Howeyer* dynamic variables disappear as soon as the 
run-time error occurs. 

The operation of DEBUS in a .multi-ring environment is not 
nel l-def i ned. DEBUG only gets control when. the program executes 
in the same ring as set by the SCL command Set_Debug_Ri ng. 



4. DEBUG does not coordinate 
asynchronous tasks* 
PSR 088A076 



its prompting activities between two 



DEBUG does not accept hyphenated names 
parameter values. CQ80L users may use the 
parameters in line mode DEBUG. Full 
remove the hyphen from the program is 
r ecompi I e. 
PSR D88A054 



for HQOULE or PROCEDURE 

default value for these 

screen DEBUG users must 

statement name and 



5.7 A£ 



1. AFIFIX is needed in order for the APL/VE conversion utility to 

successfully convert **APL structured files" from APL2 format to 

APL/VE format. Installation of AFIFIX is discussed in Section 
3.1.2 of this SR8. 

APL2 structured files are NQS random files with a format that only 
APL2 understands. If the user attempts to bring a random file 
over to NQS/VE using get_file* the records get packed together* 
and as a result the randoi file directory becomes meaningless* and 
can no longer be used to locate the records. AFIFIX copies files 
to get rid of EQRs so that they can be brought across to NOS/VE 
without their random file directories becoming out of synch with 
the data. So the user must apply AFIFIX to all APL structured 
files 2Q_£|je._!$i]£_s.ia;ejL-£i££2Le. using the APL/VE conversion utility 
on them. To use AFIFIX* enter? 



GET*AFIFIX/UN=APL0. 
and then either 
AFIFIX*LFN1. 



(to only get the control byte 
set* which is why current 
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or 



AFIf IX*N0E0R*LFN1. 



APL2 users use AFIFIXJ. 
(to get the control byte set 
and to get the file copied 
without EORs so it can be 
brought over to APL/VE via 
the conversion utility). 



5 . 8 £ii£_tti£& AIIXW-AIfl 



1. Oo not use »CL£AR» or "RETURN*** to clean up NOS files. This will 
delete internal FHA files and cause FNA to fail. Also* executing 
an EXIT control card will causa FHA to fail. This item is a 
earning only and Mill also appear in the Migration Guide. 



5.9 SOU 



When a predefined key name* e.g.* CG8QL6* is used for a user 
specified collating sequence name* diagnostic message 610110 may 
show up twice to indicate the error though one error message is 
sufficient. 
PSR SH8A105 



2. 



If a nonexistent file 

S0RT/HERG£# an empty 
system. 



is specified by the 01 R 
file by that name will be 



parameter of 
created by the 



3.10 EASIER 

In order to allow comparisons of Hoi 
variables* the code for .£9* ani .N£ 
real operands has been changed to do a b 
operands* rather than a floating do 
emphasizes the need to maintain alt real 
floating point numbers or zero 
compulations. The compiler automatic 
constants and the results of all f 
normalized operands will be normal 
unnormalized values can be introduced by 
egui va lenci ng to other data types or var 

5.11 USE 



lerith data stored in real 
. relational expressions with 
it-by-bit comparison of the 
int comparison. This change 

values as standard normalized 
In order to ensure correct 
ally normalizes all real 
ioating point operations with 
ized* but nonstandard or 

means of boolean expressions* 
ious input operations. 



1. At this release* LISP/VE is a partial implementation of Common 
Lisp. The functions implemented for Rl.1.2 were chosen to provide 
the user an adequate worKfng base for common programming 
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applications* The list of functions currently supported is 
available in the LISP/VE Language Definition Usage Supplement* 
publication number 60486213. 

2* Performance will not be optical until the compiler is available at 
a later release. In particular* the print function* when 
implemented with the full capabilities was slow. LISP/VE 
therefore provides a faster (but less capable) version of the 
print function, named "print*** and the complete version has been 
named "slow-print". Patience is important until the compiler is 
complete. 

3. When the system editor is called from within LISP/VE* the editor 
parameter X«CQMMAND must be used. For example* 

(VE-COHHAND "EQIF HYFILE I=C3^NAND W ). 

4. NCONC causes LISP to hang if oassed a circular LIST. User break 
can be used to terminate LISP when this happens* 

5. When a file F contains an unmatched vertical bar* for example! 
(setq a lx). loading that file causes LISP to hang. 

6. LISP aborts if it runs out of available space. This happens 
because NOS/VE aborts LIS? instead of giving it control when a 
segment overflows. 

7. NOS/VE will hang when it is given a line of more than 2000 or so 
characters. To exit when this occurs one must disconnect the 
terminal session* sign back on* and execute a term! nate_ job NOS/VE 
command to kill the job. The displaying of the stack sometimes 
causes this to happen. 

5.12 Mi££I-Ma£-UIILm 

1. A new version (VI. 1) of object code library format has been 
Implemented to support improved message template capabilities. 
Message template modules are now created through the QCU 
€REATE_H£SSAGE_HQDULE subcommand which places message template 
modules on the object library. The OCU on the Rl.1.2 system can 
accept object modules from both old (VI. 0) and new (VI. 1) 
libraries but will only generate new (VI. 1) format libraries. 
Libraries created by the Rl.1.2 OCU cannot be used by previous 
versions of the system or previous versions of OCU. Object 
modules (but not SCL procedures or program descriptions) can be 
moved from a VI. 1 library to a VI. library as follows* 
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a. Using the VI. 1 CREOL* do the following* 

CREOL 

AODH vll. library "version VI. 1 library" 

G£NL object. file f«f "generates an object file' 1 

b. Using the VI. CREOL* do the following) 



CREOL 

ADDN object.fl le "generated as above" 

G£NL vlO.llbrary "version Vl.D object 



I i brary" 



5*13 a££SAfiE_I£a£UI£S 



1. Previous versions of message template modules cannot be used by 
the Rl.1.2 system. They must be rebuilt using the 
GENERATE.HESSAGE.TEHPLATE.WOOULE- procedure. A HQDULE statement 
must be placed at the beginning and a HODEND statement at the end 
of the message template definitions In order to provide the name 
for the message template module on the OCU library. The message 
template module should be placed on the same library as the 
program description and CY8IL modules for the application program. 



5.14 E£2MAiLXMI£REA££ 



1. Changes to the program interface 
CY8IL modules. Modules ahich 
encounter 'declaration mismatch* 
addition* any modules bound with 
rebound. 



require the r ecompi lat I on of all 

have not been recompiled may 

errors when they are loaded. In 

runtime libraries will have to be 
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6.o aasi-simiusaits 

1. The BATCHIQ printer driver does not correctly handle long lines 
Cover 135 characters). The extra characters are either dropped* 
overprinted* or cause the page to be spaced erratically* 

?SR NS2C121 

6 . 2 sa$£ft£_u*z-Q££&Aiiafi_mi£:i' 

1. The N0S/8E terminal driver always issues a line feed CLF) in 
response to a carriage return (€R) sent from a terminal. This 
causes a problem Ht\er\ using the NOS/VE Full Screen Editor (FS€) 
with terminals which consider the home position (command line) to 
he the last line of the display nn6 do not have a page mode* For 
terminals like this* such as the CDC 722-10* the user should clear 
the screen (followed by a CR) to cause the NOS/VE FSE to repaint 
the entire screen* 

2. NOS/VE fails to deadstart after a NQS/BE checkpoint/recovery 
deadstart due to checkpoint flags set in the Environment Interface 
face Communication Slock. 

Solutioni 

Install N80E477 from SOLVER. 

3* NVE subsystem control point hangs after a level 3 recovery 
deadstart due to coding error in IAS. 

So Jut ion: 

Install N80E481 from SOLVER. 

4. The 0ST1 job on the installation decks PL wi I I not install NOS/VE 
binaries correctly. 

Solution: 

Install the following modification to the installation decks* 

-IDENT C75350ST 
=8 HISTORY. 2 
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C75350ST CORRECT VE ROUTINE EDITLI8. 
JM8 03/1*5/85 0ST1 

*C HISTORY 

*D C7535DK.7 NEAR DST1.315 

REPLACE CFASUVEjNUCjAL* I fFL*23100) 

•0 C7535DK.18 NEAR DST1.629 

REPLACE(DSHRUN#NVe#AL«l»FL***O00) 

«D C7535DK,21>31 

SETAL(CLOSLNK#0) 

$ETAL(G£TLNK>0) 

SETAL<G£TNLNK»OI 

S£TAL<GETPLHK*0) 

SETAL(HLIF#0) 

SETALOjPENLNKjO) 

S£TALCPUTLNK#0) 

SETAL(PUTNLNK»0) 

SETALCPUTPLNK*0) 

SETAL(yREPLNKfO) 

S£TAUIC7NMLI»0l 

»C 0ST1 
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7.0 E£A-L£id£LS 



NOS/VE VI. 1.2 level 630 Has tested In an environment containing the 
following hardware and software components • 

COMPONENT RELEASE LEVEL 



7155/835 ifHQ) 1A721-A10 

7021/67X (FIRM66X) J1B434-A14 

CYBER Initialization Package CIP003 
HOS V2.4.1 level 630 

CML Level 170 

NOS/Bc VI. 5 level 627 



The following components are certified at the indicated levels* 

MODEL FCA Index * CIP CM. NOS NOS/VE I^OS/BE 



CYBER 


810 


TBD 


CYBER 


815 


T8D 


CY8ER 


825 


TBD 


CYBER 


830 


TBD 


CYBER 


835 


TBD 


CYBER 


840 


TBD 


CYBER 


845 


TBD 


CYBER 


850 


TBD 


CYBER 


855 


T8D 


CYBER 


860 


TBD 



003 170 V2.4.1 L630 VI. 1.2 L630 VI. 5 L627 

003 170 V2.4.1 L630 VI. 1.2 L630 VI. 5 L627 

003 170 V2.4.1 L630 VI. 1.2 L630 VI. 5 L627 

VI. 1.2 L630 VI. 5 L627 

VI. 1.2 L630 VI. 5 L627 

VI. 1.2 L630 VI. 5 L627 

VI. 1.2 L630 VI. 5 L627 

VI. 1.2 L630 VI. 5 L627 

VI. 1.2 L630 VI. 5 L627 

t3 170 V2.4.1 L630 VI. 1.2 L630 VI. 5 L627 



003 


170 


V2.4.1 


L630 


003 


170 


V2.4.1 


L630 


003 


170 


V2.4.1 


L630 


003 


170 


V2.4.1 


L630 


003 


170 


V2.4.1 


L630 


003 


170 


V2.4.1 


L630 
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8.0 £UIU&£S 

This section is to commun i ca te so«n« future customer impacts expected in 
and prior to NQS/VE Rl*l*2«» alibiing the customer to be better prepared 
at the tiwe of that release* 

NOS/VE Rl.1.2 Hill be certified with NOS 2.4.1 as its dual state 
partner* Based on Control Data's software support policy* NOS/VE Rl.1.2 
will also be supported in fiLili£vaL-£S&-iadfi-ftflIl with the dual state 
partner NQS Release 2.3 Level 617.; 

IRHF allocs a user on NOS to route a NOS/VE batch job as follows* 

R0UTE.fi lename* DC =LP#FC*Rr! 
or 

ROUTS. fi lenamet DC«IN»ST*NV£ 

For NOS/VE R1.1.3> the capability to use the first route {route to 
output queue) *ill be removed* 

At NQS/VE Rl.1.3* the INFORHATIOM. LEVEL* lip parameter of all SCU 
commands will be changed to DISPLAY. OPTION* DO. 
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Al .0 SAtt£L£-£&flC£ail&£S-£Q8-aii£UIIJlfi-EAILUa£-aAIA 

The following SCL procedures are provided as an example of horn to use 
DISPLAY. BINARY.LOG to obtain failure data. It is necessary to include 
$systeauosf$s i te.command.l ibr ary in the user's command list to use 
0ISPLAY.BINARY.LOG. 

Al.l aiaa.AX-OISIL.EAILUfiL£_ttAIA 

PROC di spl ay.disk.fai lure.data »disdfd i •* 

iog»ls file 3$) oca I . $ engineer i ng. log; •• 

outputjot file * Soutput) 
display.binary.log i *$value{ I og) o*$vat ue( output I 
define. group system. act! on s tati sti c*C?1350000 
define.group sof taar e.f ai I ur e st at! stl c=C135Q0Ol 
define. group $7155. f ai lur e s tati sti c»CH35O0Q3 
dunip.gr oup group*sys tem.acti on cf *( (l.«4*8)» (5.*7#10)) 
dufflp.gr o up group's of tware.f a i lure cf- { (1«.4# 8)* C 5. .8#10) I 
dump. group gr oup»$7155.f ai lure *u 

cf-(tl«.4»8)*<5.«10»10)»{ll,a6t3)»U7tlO)»(18..60#8)) 

quit 

PRQCENO dispi ay.disk.fai lure.data 

Al.1.1 IS PLAY.T APE. FAILURE. DATA 

PROC displ ay. tape.fai lure.data »'distfd C • « 
log*|s file *$ local * $eng i near i ng. I ogl *• 
output#o* file • Soutput) 

display.binary.log i *$value{ log) o=$va| ue( output ) 
define.group group«$7021.f ai I ure stat i st i c*CM351002 
dump. group group»$7021.f ai lure . . 

cf*(U**4»8)#(6««9»10).»<10.<«£5t8)» .. 

<26..2 8>10),<29,16),<3O#lO)*{3l.*62t8n 
guit 

PRQCENO displ ay.tape.fai lure.data 
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A2.G B££gti£I$y&AIIflli 

A2.X A5Syfl£IIQfl5 

1. The reader is already familiar Kith the N3S/VE installation and 
deadstart process but is not familiar with what to do in 
particular failure situations* 

2* The system analyst will look at the NGS/VE operator console for 
failure information in the event of a system failure* If the 
system has not failed hut peripheral failures are suspected* the 
system analyst Hill look at the Engineering Log for failure 
information* 

3* The site has generated a deadstart tape with the specified 
physical and logical configurations as depicted teelow* Unless 
otherwise specified* assume the site has installed NQS/VE* has 
been running the systen* has permanent files on disk and has 
backup tapes of the permanent files* 

4* If the performance of the system is degrading and there is an MOD 
console* see if unrecoverad disk failure(s) have been reported* 
Alternatively* use the DIS?L AY_3INARY_L0G command to determine 
whether unrecovered disk/tape failures have been reported in the 
Engineering Log* 

5. The first alternative to consider when a peripheral failure is 
suspected is to terminate ^35/VE (if still running) and revert to 
NOS (single-state execution). Vhm NQS/VE is terminated, all 
devices remain DOWN in the NOS configuration* Therefore MALET may 
be used on NOS to isolate and repair peripheral hardware problems* 
If the problem is a hardware logic failure and is repaired* one 
should he able to perform a continuation deadstart and resume 
normal operation* If this alternative is not chosen and the 
failing element is the system deadstart controller or disk drive* 
any modified data in NQS/VE real memory at the time of the failure 
will be lost* 

6* If repair will take too long or files will be lost as a result of 
the failure* the discussion below is pertinent. 
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A2 . 3 CflliEIfiU&AIIJ3ii-£l-=-SIllfiL£.CQhlI&aLL£E 

Note that the disk and tape units are only accessible from one 

controller* This is not a recommended configuration from the 

standpoints of fault tolerance and system performance. Compare the 
following scenarios with those of configuraton #2* 

channel C channel 2 channel 6 

* i i 

* it 

* * t 

t 1 ! 

disk disk tape 

controller controller controller 

* t * 

* i • 

* « • 

* t i 

unit {system J yn 1 1 3 1 unit40— * 

unit 1— — I unit 4 * 



A2*3.1 DISK RECONFIGURATION SCENARIOS 

Listed be I on are scenarios far possible disk failures which require a 
NQS/VE deadstart or which occur while deadstarting NQS/VE* Assume that 
in each case the desired recovery action Is to change the configuration 
and resume operations as soon as possible* In the discussion below a 
•bad HDA» refers to the disk pack counted on a disk drive) failures such 
as headier ash or a bad head nay cause data to be recorded improperly or 
to be incapable of being read* 

1* Assume 1) a bad HDA on disk #1 {not system device) or 2) a failure 
in disk drive #1 which will take too long to repair and no spare 
disk drive. The desired result is to delete disk #1 and continue 
degraded operation with only 1 disk {#01 on channel #0* 

a* Rebuild the NQS/VE deadstart tape with a new configuration 
prolog* The new prolog should have the failing device in 
the physical configuration but not in the logical 
configuration* i.e. the INSTALL_LOGICAL_CONFIGURATION 
subcommand of the LIGICAL^CONF IGURATIQN.UTILITY UCU) should 
•exclude* the failing element* In addition the 
configuration prolog may need to be changed if it was set up 
to INITIALIZE.HS.VOLUNE and A00.V0LUHE.T0.SET for the 
falling element) these subcommands must be deleted* 
b* Perform an •installation deadstart 1 of NQS/VE* 
c* Reload permanent files. Since you now have only 3 disks* 
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you may need to reload files for a subset of the users and 
tell the rest of your users to wait for the fourth disk to 
be repaired, 

d. Resume operation in a degraded mode* 

e. When the failing disk has been repaired* execute the LCU to 
re-install the logical configuration to 'include 1 the 
repaired element* Mote that the newly installed logical 
configuration Nil! not become active until the next 
continuation deadstart. 

f. When convenient do a TE*miNAT£_SY$TEH and then a 
continuation deadstart. This will activate the logical 
configuration installed above. 

g. Execute the L:U to INITIALIZERS. VOLUME and 
ADO_VQLUHE.TO.SET for the repaired element* 

h* Reload any permanent files not previously reloaded* 
i. Continue with normal system operation. 

2* Assume 1) a bad HDA on disk #0 {system device) or 2) a failure in 
disk drive #0 which Hill take too long to repair and no spare disk 
drive. The desired result is to delete disk #0 and continue 
degraded operation with only 1 disk C#X) on channel #0. 

a. Rebuild the NQS/VE deadstart tape on the NQS system. The 
SET.DEADSTART.DEv'ICE" system-core command must be changed to 
reflect the type of unit and the unit-number <U for the new 
system disk. The configuration prolog must also be rebuilt* 
The new prolog should have the failing device CO) in the 
physical configuration but not in the logical configuration* 
i.e. the INSTALL.L3GTCAL. CONFIGURATION subcommand of the 
LCU should 'exclude* the failing element. In addition the 
configuration prolog may need to be changed if it was set up 
to INITIALIZERS.V3LUNE and ADD.VGLUME.TO.SET for the new 
system device! these subcommands must be deleted* 

b* Perform an 'installation deadstart' of NQS/VE* 

c. Reload permanent files. Since you now have only 3 disks* 
you may need to reload files for a subset of the users and 
tell the rest of your users to wait for the fourth disk to 
be repaired. 

d. When the failing disk has been repaired* execute the LCU to 
re-install the logical configuration to 'include' the 
repaired element. Note that the newly installed logical 
configuration will not become active until the next 
continuation deadstart. 

e. When convenient do a TERMINATE.SYSTEH and then a 
continuation deadstart. This will activate the logical 
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configuration installed above. 

f. Execute the LCU to INTITIALIZ£_M$_¥0LUM£ and 
ADD_VOLUN£_TtL.$ET for the repaired element. 

g. Reload any permanent files not previously reloaded* 
h. Continue with normal system operation* 

3. Assume 1) a bad HDA on disk #3 {not system device) or Z) a failure 
in disk drive #3 which ail I take too long to repair and no spare 
disk drive* The desired result is to delete disk #3 and continue 
degraded operation with only 1 disk <#4) on channel #2* 



a* 



f. 



Rebuild the HOS/VS deadsta 
configuration prolog wil 
prolog should have the 
configuration but not I 
the INSTALL.LQGICAL.CONF 
LOGICAL.CGNFISURATIONJJTIL 
failing element* In addit 
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g. Reload any permanent files 
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d. W 
t 

c 
c 
c 

e. W 
c 
c 
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rt tape on the NOS system. The 
I need to be changed* The new 
failing device in the physical 
n the logical configuration* i.e. 
ISURATIQH subcommand of the 
IT* (LCU) should 'exclude* the 
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eadstart* of HOS/VE 

Since you now have only 3 disks* 
es for a subset of the users and 
ers to wait for the fourth disk to 

b^en repaired* execute the LCU to 

lament in the installed logical 

t the newly installed logical 

become active until the next 

T€RNINAT£_SY$TEH and then a 
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o INITIALIZ£J1$_VQLUME and 
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4. 



Assume the controller on channel #o requires repair and that the 
repair will take too long.? The desired result Is to delete the 
failing controller from the configuration and continue degraded 
operation with the single controller on channel #2. 



a* Have a Customer Engineer recable units and 1 to the 
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controller on channel 2* 

0* Rebuild the NOS/VE deadstart tape on the NQS system* A new 
configuration prolog Is required. The new prolog should 
show units and 1 being connected to the controller on 
channel 2* The configuration prolog should also be changed 
to •exclude 1 channel from the installed logical 
conf iguration. The SET J5EA0$TART„C0NTR0LLER system-core 
command may need to be changed if the controller on channel 
#2 has a different product.! denti fi cat! on than the one on 
channel #0* 

c* Oo a SETVE to change the deadstart channel number frost to 
2. 

d» Perform an * instal 1 ation deadstart* of NOS/VE* 

e. Reload permanent files* 

f* Continue degraded system operation* 

g* When the failing controller has been repaired* use the 
INSTALL.PHYSICAL.CONFIGURATION subcommand of the 
PHYSICAL.CONFIGURATIONJJTILITY to re-install the original 
physical configuration. iote that the newly installed 
physical configuration will not become active until the next 
continuation deadstart* 

h* When convenient do a TERHINATE_SYST£N* Recabiing cannot 
occur while the NOS/VE system is executing* 

i* Recable to match the installed physical configuration* 

j* Perform a continuation deadstart* 

k* Continue with normal system operation. 

5* Assume the controller on channel #2 requires repair and the repair 
will take too long* The desired result is to delete the failing 
controller from the configuration and continue with the remaining 
controller on channel #0* 

a* Have a Customer Engineer recable units 3 and 4 to the 
controller on channel fO* 

b. Rebuild the NOS/VE deadstart tape on the NQS system* A new 
configuration prolog is required* The new prolog should 
show units 3 and 4 being connected to the controller on 
channel #0* The configuration prolog should also be changed 
to 'exclude 1 channel 2 from the installed logical 
configuration* 

c* Perform an • instal 1 at i on deadstart* of NOS/VE* 

d* Reload permanent files* 

e* Continue degraded system operation* 

f* When the failing controller has been repaired* use the 
INSTALL. PHYSIC AL.CO^i FIGURATION subcommand of the 
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PHY$ICAL_CQNFIGURATIOM_UTXLITY to re-install the original 
physical conf i gurat i on. Note that the newly installed 
physical configuration does not become active until the next 
continuation deadstart» ? 

When convenient do a TERNIMATE_$YSTEH. Recabling cannot 
occur while the NOS/VE system is executing* 



h* 
i . 



Recable to watch the installed physical configuration* 
Perform a continuation deadstart* This will activate th< 
physical configuration installed above* 
Continue with normal system operation* 



6* Assume 1) the HOA on disk #1 (not system device) is not damaged 
and 2) the failure in dis< drive #1 will take too long to repair 
and 3) a spare disk drive* The desired result is to delete the 
falling device* to move the disk pack from the failing drive to 
the spare drive* and to continue normal operation* 

a. This assumes that a spare disk drive has been physically 
configured and that the disk pack <HDA1 normally mounted on 
the drive is not currently used by N0$/VE» i.e* the disk 
drive is defined in the installed physical configuration but 
not in the installed logical configuration* If these 
assumptions are not valid* then follow one of the earlier 
scenarios concerning a failing disk drive* 

b* Remove the disk pack CHDA) from drive #1 and mount it on the 
spare drive* 

c» Perform a continuation deadstart and request operator 
i ntervent ion* 

d* from within the LCI) use the IHSTALL.LOG ICAL ^CONFIGURATION 
subcommand to 'exclude' drive #1 and 'include* the spare 
drive* 

e. Continue normal system operation* 

7. Assume 1) the HOA on disk #0 (system device) is not damaged and 2) 
the failure is in disk drive #0 which will take too long to repair 
and 3) a spare disk drive. The desired result is to delete the 
failing device* to move the disk pack (HDA) from the falling 
device to the spare device and to continue normal operation* Note 
that 835-lx IF HO I HOAs car* be removed by a C£ and moved to a spare 
drive* Operators can move 844-4x drives themselves* 

a* This assumes that a spare disk drive has been physical I y 
configured and that the HOA normally mounted on the storage 
device is not currently used by NOS/VE* i*e* the disk drive 
is defined in the installed physical configuration but not 
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in the installed logical configuration* If these 

assumptions are not valid* then follow one of the earlier 

scenarios concerning a failing disk storage element* 
b* Remove the disk pack (H9A) from drive #0 and mount the pack 

on the spare drive* 
c* If the disk pack was moved to channel #2 use the S£TV€ 

command to change the deadstart channel from to 2* 
d* Perform a continuation deadstart and request operator 

intervention* 
e» If necessary change the SET_.DE ADSTART_CONTRQLL£R system-core 

command to specify the product-identification of the 

control I er* 
f* Change the SET_.DE ADSTART_MVICE system-core command to 

identify the unit number of the spare drive* 
g* From Hi thin the LCU use the INSTALL J.OGICAL.CONFISURATION 

subcommand to 'exclude' drive #0 and 'include 1 the spare 

dr i ve* 
h* Continue normal system operation* 

A2.3*2 TAPE RECONFIGURATION SCENARIOS 

Listed below are scenarios for possible hardware failures which may 
occur Cor be detected) while using tape peripherals as configured in 
configuration #1* 

1* Assume a failure in the tape controller has caused a NOS/VE 
interruption* The desired result is to remove the failing tape 
controller from the NQS/VE- configuration to allow diagnosis and 
repair to occur in the NQS state concurrent with NQS/VE execution* 

a* Perform a continuation deadstart and request operator 

i ntervention* 
b* From within the LtU» re-l nstal I the logical configuration 

and •exclude* channel 6* 
c* Continue operation without the tape controller* 
d. When the tape controller has been repaired* execute the LCU 

to re-install the logical configuration and 'include' 

channel #6* Note that the newly installed logical 

configuration wilt* not become active until the next 

continuation deadstart. 
e* When convenient do a TERHINAT£_SYST£M and perform a 

continuation deadstart to activate the newly installed 

logical configuration* 
f* Continue with normal operation* 
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2* Assume a failure in the tape controller which does not cause a 
NOS/VE Interruption. The desired result Is to remove the failing 
controller from the NOS/VE- configuration to allow diagnosis and 
repair of the element to occur in the NOS state concurrent with 
NOS/VE execution. 

a. Execute the LCU to re-install the logical configuration and 
'exclude* channel #6. Note that the newly installed logical 
configuration does not become effective until the next 
continuation deadstart* 

b* tfhen convenient do a TERHINAT£_SYSTEN and perform a 
continuation deadstart*? 

c* Continue operation without the tape controller* 

d* When the tape controller has been repaired* repeat the 
process above to * i n» ct u de • channel #6. 

3. Assume that tape unit #40 has failed* Also assume that this 
failure has not caused a NOS/VE interruption* The desired result 
is to replace unit #40 with a different tape unit from the NOS 
configuration* use the NOS state for diagnosis and repair of the 
failing element and continue NOS/VE execution* 

a. Use the PCU to re—install the physical configuration 
omitting the failing tape unit and adding the replacement 
tape unit* Note that the newly installed physical 
configuration will not become active until the next 
continuation deadstart. 

b* Use the LCU to re-install the logical configuration* Note 
this is necessary because the LCU captures some of the 
information in the installed physical configuration which 
changed above* 

c* When convenient do a TERHINATE^SYSTEM and a continuation 
deadstart* 

d* Continue with normal system operation* 

4. Assume that tape unit #40 has failed and the failure caused a 
NOS/VE interruption* The desired result is to replace unit #40 
with a different tape unit from the NOS configuration* use the NOS 
state for diagnosis and repair of the falling element and continue 
NOS/VE execution* 

a* Perform a continuation deadstart* 

b» After deadstart run the PCU to install a new physical 

configuration which oults the failing tape unit and defines 

the replacement* 
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c. Do a TERHINaTE.SYSTEH and perform another continuation 
deadstart to activate the newly installed physical 
configuration* 

d« Continue normal system ooeration* 
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hZ.h £Qli£IfiilgAIII»J-i2.=-ttyLII£L£-£Q!!lISQLLEBS 



channel 



channel 1 



disk 
control I er 



di sk 
control I er 



— — < system) unit • 



channel 2 



channel 3 



tape 
control ler 



tape 
contro I ler 



• — un j t 2- 

* 

— unit 1- 



Listed below are senarios for oossible hardware failures that may 
require a NOS/VE deadstart or may occur while performing a NOS/VE 
deadstart* The following scenarios can also be applied to the case 
where the failure did not cause a NOS/VE interruption* In this case one 
can execute the LCU to •exclude 1 a failing controller* do a 
TERJilNATE.SYSTEN when convenient and then follow the steps below 
omitting the operator intervention and consequent LCU execution* 



A2.<*.I DISK RECONFIGURATION SCENARIOS 

The following describes the recommended approach for dealing 
failure of one of the two disk controllers in configuration #2 



with the 
above* 



1* Assume the site has configured to channel #0 unit #0 for the 
deadstart device and the controller on channel #0 fails* The 
desired result is to return the controller to the NOS state for 
diagnosis and repair and to continue degraded operation minus the 
fail ing control ler* 

a* Execute SETVE command to change the deadstart channel number 
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from to 1* 
h. Perform a continuation deadstart and request operator 
intervention. 

c. Change the SET.DEADST'ART. CONTROLLER system-core command if 
the product.ident if teat I on of the controller on channel #1 
is different than that of the controller on channel #©• 

d. From within the LCU use the INSTALL.LOG ICAL .CONFIGURATION 
subcommand to 'exclude 1 channel #0. 

e* Continue degraded system operation* 

f. When the failing controller has been repaired* use the LCU 
to re-install the logical configuration and •include* 
channel #0.' Note that the newly installed logical 
configuration will not become active until the next 
continuation deadstart. 

g. When convenient do a T?RMINAT£_$Y$TEH and perform a 
continuation deadstart to activate the newly installed 
logical configuration. 

h# Continue normal system operation. 

2. Assume the controller on channel #1 fails. The desired result is 
to return the failing controller to the NOS configuration for 
diagnosis and repair and to continue with degraded system 
operation minus the failing controller. 

a. Perform a continuation deadstart and ask for operator 
intervention. 

b. From within the LCU use the INSTALL.LOGICAL.CQNFIGURATIQN 
subcommand to »exclude» channel #1. 

c. Continue degraded systsm ooeration. 

d. When the failing controller has been repaired* use the LCU 
to re-install the logical configuration and 'include 1 
channel #1. Mote that the newly installed logical 
configuration will not become active until the next 
continuation deadstart. 

e. When convenient do a TFR1INAT£_SYSTEM and perform a 
continuation deadstart to activate the newly installed 
logical configuration, 

A2.4.2 TAPE RECONFIGURATION SCENARIOS 

The following is the recommended approach for dealing with the failure 
of one of two tape controllers reconfiguration #2 above. 

1. Assume one of the control I ers on either channel #2 or channel #3 
fails. The desired result is to return the failing tape 
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controller to the NQS state for diagnosis and repair and to 
continue degraded operation minus the failing controller* 

a* Perform a continuation daadstart and ask for operator 

i ntervention* 
0. Froa aithin the LCU use the INSTALL.LQGICAL ^CONFIGURATION 

subcommand to 'exclude* the channel with the failing 

controller* 
c. When the failing controller has been repaired* use the LCU 

to re-install the logical configuration and ■include 9 the 

channel with the failing controller* Note that the newly 

installed logical configuration will not become active until 

the next continuation deadstart* 
d* When convenient da a TERMINATE.SYSTEM and perform a 

continuation deadstart to activate the newly installed 

logical configuration* 
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81. 1 ifll&QaUfillfltf 

Failure data for peripheral devices dedicated to NOS/VE are emitted as 
statistics to $ENGIN££RING.LOS in binary format {Section AX-ll* The 
statistics facility command QI$PL4Y_8INARY_L0G provides a mechanism for 
monitoring those errors encountered during system operation. While this 
facility can be used by anyone via SCL commands* the format of the 
output does not describe the status fields in sufficient detail to 
permit easy interpretation. Three Independently executable SCL 
procedures are provided that produce several reports by editing the 
output of DISPLAY_8XNARY_LQG, These procedures are included in library 
$SYSTEM.a5F$SITEj:aH«AND_LI8RARY. A certain amount of execution time 
overhead is incurred as a result of using SCL to do the editing, but the 
command structure is easily modified to include new statistics that may 
be added in subsequent releases. 

B1.2 ii£&& 

These procedures are initiated Interactively by the commands 
DISPLAY_HPA_SUNMARY (DISHSI* DI$PLAY„HPA_DIS)<_0ETAIL <DISHDD)# and 
DISPLAY_HPA_TAP£J)ETAIL (DISHTD). There are no required parameters. 
Default output is $GUTPUT. Default input is the current system 
$£NGXN£ERING_LOG« Alternative files many be specified by the following 
parameters * 

input* i : file 
output* o : file 

These procedures should be initiated immediately prior to terminating 
SENGINEERING.LOG via the TERHINATS.iaG command. Alternatively* the file 
created by the TERMINATE..LOG command should be used as input to these 
procedures to insure that all statistics have been evaluated. See the 
SAMPLE BATCH PROCEDURE described later in this section. 

bi . 3 fiimAL.a£A.&yaflA&x-imasi: 

This procedure displays summary information in the following format* 
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<DISPLAY_3INARY_L0G header> 



* descriptive data 
* 

* descriptive data 



count 



count 



The descriptive data has the fol toning format! 

<mf>*<pp>*<channel >.<controt ler>.<uni t>*<vsn>*< sever i ty>*<symptom> 

ahere* severity can be UF <unrecovered failure) or RF (recovered 
failure)* Entries will appear in ASCII collating sequence of the 
descriptive data string* 

This report uses the OISPL'AY.BINARY_LOG di sp I ay.descr i pt i ve_data 
subcommand* The report provides up to five sections depending on the 
types of statistics contained in $£NSINE£RING_LOG* These sections can 
be used to determine if the number of statistics reported against a 
subsystem warrant further inspection or maintenance activity* 

The descriptive data in this report is also the first line in the tape 
and disft detail reports* It will be truncated at 56 characters and 
result in loss of message text ahen long <mf>» <control I er >» or <unit> 
values are used. PSR NV0E985 documents this problem. A value of 99 for 
PP number nil I occur when the failure occurs on the system deadstart 
devi ce. 

b i . 4 iiisi^ Ai.ii£A.MSii-a£iaiL.iai5!iaai 

This procedure displays disk statistics in the following format* 
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81.0 PERIPHERAL MAINTENANCE PROCEDURES 
81.4 DISPLAY.HPA.DISK.DETAIL (DISHQO) 



///////// 

// it i I i // 
///////// 
///////// 



<DISPLAY.8INARY.L0G header> 

<statistic number> <julian date> 

GEN DETAIL STATUS 

FCN TY £ UN CYL TK SC STAT 123456789 10 

hhxroiMss descriptive data 
fen ty e un cyl tk sc stat/ 

ERROR PQS cyl tk sc / 

FINAL STAT UNREC ERR stat/ 

/ 

GPCD* REQUEST RTY- SECTOR RTY* RESIDUAL CNT« 

wheres descriptive data is the s^e as in the summary report (up to 80 
characters long)* and the remaining fines are described as follows! 

<fcn><type><eq><unit><cyi track sector ( INITIADXgen status> «■ det stat 1-1* 

ERROR POS <cyi track sector C FAILURE) > ♦ det stat 11-20 

FINAL STAT UNREC ERR <gen s tatC FAILURE ) > + Z X 10 det stat (only when UF ) 

This report uses the DISPLAY. 8INARY.LOG generate.group.fi I e subcommand. 
The report provides up to four sections depending on the types of 
statistics contained in $ENGI>I€ERXNG JLOG« The entries in each section 
appear in chronological order* The values in the descriptive data* 
counts* oped and equipment type are decimal. All other values are 
octal* All fields are initialized to blanks* and only valid data is 
quanti f i ed* 

81 .5 UllZL&lJiMJLktgJ&UlL-tilZmmi 

This procedure displays tape statistics in the following format* 
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B1.0 PERIPHERAL MAINTENANCE PROCEDURES 
81.5 DISPIAY_HPA_TAPE_DETAIL (OISHTO) 

<DISPLAY.8INARY.LQG header> 

<statistic number> Cjulian 4ate> 

STATUS 
OPCO TYP ?? CH EQ UN RTY b£H GS1 GS2 0S3 0S4 OSS D$6 0S7 OS 

hhsnmsss descriptive data 

oped typ pp ch eg un rty den //////// 

FORMAT* //////// 

BLOCK COUNTS CURR» READ* WRITTEN* 

where* descriptive data is the same as in the summary report (up to 80 
characters long). Refer to Section A~5»6 for further details* 

This report uses the OISPLAYJJINARY.LQS generate.group.f i le subcommand* 
Currently the only statistic being logged for the tape subsystem is 
unrecovered 679 errors* The entries **ill appear in chronological order* 
The values in the descriptive data* counts* oped and equipment type are 
decimal* All other values are octal* All fields are initialized to 
blanks* and only valid data is quantified. 

81*6 SA&£L£-fiAI£H-£RQ££flUB£ 

a* Create a permanent file containing the following procedure* 

^ROC run.dish < 

input* i s file * SI oca! »$engi neer I ng_log 
output* o? file « Soutput 
status ) 

di spl ay_hpa_disk_detai I Sval ueC i nput ) Sval ue(output) 
di spl ay.hpa.t ape.detai I $val ue< i nput ) $val ue (output) 
di spl ay.hpa.sunmary $value( i nput ) *v a I ue( output ) 

PROCEND run. dish 

b* To run this procedure fro* a terminal and display output to the 
terminal i 

1* Attach the file created in step a. as run. dish 
2* Enter H run_dish»* 

c* To run this procedure from a terminal and route the output to a 
printer : 
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81*0 PERIPHERAL MAINTENANCE PROCEDURES 
81.6 SAMPLE BATCH PROCEDURE 

!• Attach the file created in step a« as run^dish 
2* Enter "run.dish o-l i st. $eoi *» 
3* Enter "print.file list* 

d. To run this procedure frou a terminal with an alternate input 
file* and route the output to a or inters 

1» Attach the file created in step a* as run_dish 
2. Enter "run_dish i*<file> o*11st*Seoi" 
3* Enter "print. file list" 

NOTE - enter the characters between the <?uotes( M ) followed by a carriage 
return* except for <flle> which must be a file created by the 
TERMINATE.LOG command. 
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C1.0 SUPPORT OF 7154 CONTROLLER 



C 1 . Sy££OEI-.Q£»Il^i^£QliIKQLl£E 



The following information is provided for those sites installing NQS/VE 
on a configuration using 7154 controllers* Users should be aware that 
NQS/VE support of 7154 controllers Is Manned to be dropped in the 
future* This information is supplied as an appendix to the SR8 and Mill 
not be incorporated into any manuals* 

To use a 7154 controller in a H1S/VE system* make the following changes* 

1. Use $7154.1 as the Pr oduct.I dent i fi cat i on in Configuration Prolog 
f i les* 

2* Use $7154.1 vhen defining the deadstart controller* 
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Dl.l kAkLIi§.IH|.£0aMM2-IMLI-i£!i£I^I0'S. 

The generator is called via the fall owing NQS/VE coma and* 

generate_contmand_tabl e \ generat e.command.tabt es \ genet 
Cinput*<file referenced] 
Coy tput*<f i le referenced 
£status*<status variabie>] 

input I i* This parameter specifies the file from which the generator is 
to read the command table daf i nti t i on* 

Omission causes $INPUT to be used* 

output J o* This parameter specifies the file to which the generator is 
to write the CYBIL declarations that represent the command table. 

Omission causes $0UTPUT to he used. 

status? See ERROR HANDLING. 

Di.2 iii£ui-ia-ia£-fi£ti£a&iQfi 

The input to the generator is in the form of a series "coiman ds** that 
declare a new table or add entries to the "current table 1 *. 

There are three different commands* TABLE* COMMAND and FUNCTION* 
Each TABLE "command" starts a new command or function table and and is 
followed by any number of COMMAND "commands" or any number of FUNCTION 
"commands". An empty table may be defined by omitting COMMAND and 
FUNCTION "commands". 

01.2*1 TABLE 

The TABLE "command" declares a new table. 

table name*<name> 

Ctypa a command I function J 
Csect ion_name«<name>3 
t scope*! ocal J xdcl 3 
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D1.0 COHHAND TABLE GENERATOR 
01*2.1 TABLE 



tmodu I e*<name>3 

name i nt This parameter specifies the name of the table* This name can 
be no longer than 24 characters. 

type J t« This parameter specifies the type of table to be generated. 
Either a Command <C) or Function <F1 table be selected* 

Omission causes a Command table to be generated* 

section_name I sns This parameter can be used to specify a section name 
for the CYBIL variable declaration* The specified section roust be 
r ead-onl y. 

Omission causes no section name to be used* 

scope I s* This parameter specifies the scope of the CYBIL variable 
declaration. Specifying XOCL causes that attribute to be used in 
the CYBIL variable declaration. Specifying LOCAL causes the STATIC 
attribute to be used. 

amission causes LOCAL to be used* 

module i ms This parameter specifies the name to be given to a module to 
contain the command or function table. If this parameter is given* 
CYBIL modu I e/modend statements are generated around the table 
declarations along with the appropriate SCU *CQPY directives to 
reference the type definition decks. If the parameter is omitted* 
no modui e/modend statements or *copy directives are included in the 
generated output. 

01*2. 2 COMMAND 

The COMMAND "command*" declares a group of entries in a command table* 
The order in which the names for the entries are provided has 
significance when the table is used by the system supplied 
DISPLAY_CQMi1AND_LIST command and in other similar contexts* The first 
entry name is taken to be the name ••nominal*' name for the command* i.e.* 
the name by which it is usually known* The last entry name is taken to 
be the "abbreviation" for the command name. Any other entry names are 
consider red to be aliases for the command name* 

command name«iist of <name> 
pr o ce s so r»<n a we> 
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01. COWHAND TABLE GENERATOR 
01*2*2 COWHAND 

tcall.method* local I xref I load ? proc 3. program] 
Cava.il ab i I i tyadvert ised * hidden] 
CI 09* automat ic J manual] 

name J names « ni This parameter specifies the names by which the 
command can be called* 

processor J ps This parameter specifies the name of the processor for 
the command. 

call_method * cm? This parameter specifies how the processor for the 
command is to be invoked* 

LOCAL - indicates that the processor is a CYBIL procedure in the 
same module as the table* 

XREF - indicates that the processor is a CYBIL procedure in a 
separate module from the table* This option causes an XREF 
procedure declaration to be generated for the processor* 

LOAD - indicates that the processor is a CYBIL procedure that must 
be "dynamically loaded" n*a*» via pmp$load) before it can be 
cai I ed. 

PROC - indicates that the processor is an SCL procedure on one of 
the object libraries that comprise the program* 

PROGRAM - indicates that the orocessor is designated by a program 
description on one of the object libraries that comprise the 
program* 

Omission causes LOCAL to be used. 

availability J a* This parameter specifies whether the command is 
Advertised (A) to users or Hidden CH) from them* A "hidden** 
command will not appear in a display of the command list entry* 

Omission causes ADVERTISED to be used. 

log * I J This parameter determines whether the logging of a call to the 
command is Automatic (A)* i *e* is done by the SCL interpreter* or 
Manual CM). I * e* is done by the command processor* Logging by a 
command processor is done in those situations where secure 
information potentially passed to the command should not be written 
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D1.0 COHNANO TABLE GENERATOR 
Dl.2,2 COMMAND 

to the log. 

Omission causes AUTOMATIC to he used. 

Dl.2.3 FUNCTION 

The FUNCTION "command" declares a grouo of entries in a function 
table* The order in which the names for the entries are provided has 
significance when the table is used by the system supplied 
OISPLAY.COMHANO.LIST function and in other similar contexts. The first 
entry name is taken to be the name "nominal" name for the function* 
i.e.* the name by which it is usually known. The last entry name is 
taken to be the "abbrevi at ion" for the function name* Any other entry 
names are considerred to be aliases for the function name. 

function name* I 1st of <naie> 
processor»<naroe> 

tea! f.method* local \ xref J load I prod 
Cavai I ab I i i ty*advert i sed * hidden] 

name I names J ni This parameter specifies the napes by which the 
function can be called. 

processor J pi This parameter specifies the name of the processor for 
the function. 

call_method 1 cm* This parameter specifies how the processor for the 
function is to be invoked. 

LOCAL - indicates that the processor is a CY8IL procedure in the 
same module as the table. 

XREF - indicates that the processor is a CY8IL procedure in a 
separate module from the table. This option causes an XREF 
procedure declaration to be generated for the processor. 

LOAD - indicates that the processor Is a CY8IL procedure that must 
be "dynamically loaded" (e.g.* via pmp$!oad) before it can be 
cat I ed. 

PROC - indicates that the processor is an SCL procedure on one of 
the object libraries that comprise the program* 

Omission causes LOCAL to be used. 
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01.0 COMMAND TABLE GENERATOR 
01. 2. 3 FUNCTION 

aval lability I as This parameter specifies whether the function is 
Advertised (A) to users or Hidden CHI from them. A "hidden" 
function Mill not appear ii a display of the function list. 

Omission causes ADVERTISED to he used. 

The output of the command table generator can best be described by an 

ex amp I e. 



Esasmis-Iaaut 



table examp le.connnand.tabl e. • 

secti on_name»oss$ job_paged_ J i ter al scope«xdcl 
command (gener ate_command - .table» ^enerate.command.tabl es> genet) 

processors I p$generate_coimand_tab I e.. 

cai l_method x xref 
command Cdi sp I ay^command.J is t# disci).. 

processor*cl p$di sp I ay.command.'l i st • • 

cai l^method*xref 

table example^funct I ©notable ty» e«funct i on 

function $time processor*cl p$$ti me 

function $peek processor*clp$$peeK avai I ab i I i ty*h i dden 

function Sfile processor-cl p$$f i I e call .method* load 



aut£Mt.tLiJi-Eiiaal£-lii£at 

VAR 

ex amp I e_comfnand..tabl et CXDCL* READ. oss$ job.paged.l i terall 
*cl t$comman datable ** A exanpl e_command_table_en tri es* 

exampl e^comffland^tabl e.entr i es t CSTATIC* READ* 
ossijob^paged,.! i ter all array CI .. 53 of 
cl tScofanand_tabl e.entr y *»■ C 

C> C'DISCL •* clcSabbreviation_entry* 

clc$advert i sed_entry> 2* ci eSautomati cai I y_J og# 
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clc$l i nk ed.cai I * A elp$di spl ay.coatfiiand. I i stl* 

C> t *DI$PLAY.CQMJ1ANQ.LI$T ** cl c$nominal .entry* 

clcSadvert ised. entry* 2* c I c$auton?ati cal ly.l og* 
cl c$ I i nk ed.cai 1 * A clp$di spl ay. co win and. I i stl* 

O C , 6£NCT f * clc$abbreyi ated. entry* 

clc$adverti sed. entry* 1* cl cSautotnat i cal I y.l og* 
clc$ I i nked.cal 1 * A c Jptgener at e.eofflaaand. table!* 

O t'GENERATE.COHHAND.TABLE »* cf cSnoai* nal .entry* 

cl c$adver t i sed.entry* 1* c I cSautomat i cai I y.l og* 
clc$l i nk ed.cai I* A clp$gener ate.couiJBand.tabi el* 

O HGENERATE.eQMMAND.TABLES »* cl c$al i as.entr y* 

cl c$advert i sed.entry* It clcSautoHiatically.log* 
clc$l i nked.cal J* A clp$genar ate. command. tabl el 3 J 

11 PUSH (LISTEXT 3= ON) 11 

PROCEDURE CXREF3 cl p$gener ate.cosunand.tab I e i 
par ameter.tab I e x c 1 1 Spar ameter. tab ! e| 
VAR status: ost$status>; 

PROCEDURE CXREF3 c I p$di sp I ay.sowBa^d.l I st i 
parameter.table* cl t Spar am eter. table; 
VAR status! ostSstatus); 

11 POP 11 

VAR 

exampl e.function. tables CSTATIC* READ! 

A cl t$f unct 1 on.tabl e »» "exempt e. function. tab I e.entr i es* 

example.f unction. table.entri ess C5T4TIC* READ1 

array Cl •• 31 of 

cl tSfunct i on.table.entry t= £ 
C> C»$FILE »* cl clnominal. entry* 

clc$adverti sed.entry* 1* c I cSI inked. cal I * A clp$$file3* 
C> t f $PEEK «* cic$no(uinal. entry* 

clcShi dden. entry* 2* e I c$l i nked.cal I * A clp$$peekl# 
O C f $TIHE '* clc$nosainal. entry* 

cl cSadverti sed^entry* 3» cl cSI inked. cal I* *cl p$$f 1 1 el! j 
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D2.o gQMhm-tmMiim 

02.1 IhI&QQU£IIfll4 

The command formatter is a tool- used to 'format a file of SCL 
commands* The formatter will read an input file of SCL commands and 
«HI generate a formatted output file, The input file may consist of 
one or more SCL PRQCs or may consist of only a portion of a PROC. 

02.2 £ M,ki ii§_IM£ JLflUlS AMO .EQEfl Ains 

The formatter is called via the following NOS/VE command. 

f ormat.scl _proc * fornat.scl .procs * forso 
nnput*<fi!e reference>l 
Coutput*<f i I e referenced 
C page. Hi dth»<integer>1 
Unit! al_indent_column»<integer>3 
t k ey_.cn ar act er = <char acter>3 
Cut! 1 1 ty.def I ni tion.fi I e*<f i I e ref er ence>3 
Cstatus*<status var i ab le>1 

input * i* This parameter specifies the file from which the formatter is 
to read the SCL PROCs or commands* This file must have the 
following file attributes* 

access.mode * read 

fi I e. contents - legible or unknown 

f i I coprocessor * scl or unknown 

fi I e_ structure » data or unknown 

Omission causes SINPUT to be used* 

output * o* This parameter specifies the file to which the formatter is 
to write the formatted SCL PROCs or commands* This file must be 
accessible to write and must have the following file attributes: 

f i I e. contents * legible or unknown 

f i I e_ processor » scl or unknown 

f I le.structure * data or unknown 
If the file has never bQer\ opened* any of the above 3 attributes 
specified as unknown will be set to the alternate value* 
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02.0 CQMNAND FORMATTER 

02,2 CALLING THE CQHMANO FORMATTED 



Omission causes SOUTPUT to be used. 

page_width * pw* This parameter specifies the page width of the output 
file. The value specified for this parameter is considered to be 
the right-hand margin of the output file. 

Omission causes the value of the page_width attribute of the output 
file to be used if the value was explicitly specified. If the 
attribute was not explicitly specified* 110 will be used. NOTE* 
The yalue of the page_nidth parameter must be at least 64 greater 
than the value of the i niti al. indent. column parameter. 

ini t i al_indent_column \ lie* This parameter specifies the starting 
column of the first line written to the output file. This 
parameter is provided so that a section of commands (such as those 
appearing as input to COLLECT^TEXT) which wli not normally be 
formatted may be extracted from a PR3C# formatted* and replaced in 
a formatted PRQC. 

Omission will cause 1 to be used* 

NOTE* The value of the page_width parameter must be at least 

64 greater than the value of the i n I t i al_indent_col umn parameter. 

key_char acter \ kc* This parameter specifies the character which* if 
appearing in column 1 of the input line* will cause the entire line 
to be written to the output file without any other formatting 
process i ng. 

Omission will cause * to be used. 

ut i I i ty.def ini ti on.fi le \ udf: This parameter specifies the file which 
contains definitions for additional utility commands which may 
appear in the Input file.? The utility names and terminators 
defined within in this file will be added to those built Into the 
formatter. 

Omission will cause only the bull t-in ut i I i t i es to be used. 

status! See ERROR HANDLING. 
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02. G COMMAND FORMATTER 
02.3 INPUT TO THE FORMATTER 



02.3 ia£ilI_IQ_Iti£_EflBHAII£& 

The input to the formatter is a file containing SCL commands. 
Usually the input consists of one or lore PROCs - starting with a PRGC 
statement and ending with a PROCEHD statement} however it is not 
required that the input be complete PRGCs. Any collection of SCL 
commands may be formatted* but SCL structure blocks within the input 
file must be complete or the formatter will report errorsm 

D2.3.X PRAGHATS 

Pragnats are special SCL comments in the input file which control the 
formatting process. A pragmat is an SCL comment with $ (dollar-sign) as 
the first character of the comnent. That i s# a pragmat begins with the 
characters "$ ( doubl e-guote dollar-sign) and is terminated with " 
(double-quote! or end-of-line. A pragmat may begin in any character 
position of a line but only blank characters may precede a pragmat in a 
line. The "command definition" of a pragmat (where "$ nay be thought of 
as the "command") is J 

"$ £command»<name>l Cformat«<boa I ean>] 

command J e* This parameter specifies the name of a utility command or a 
utility terminator. The purpose of this parameter is to inform the 
formatter that the utility name* or terminator* is "hidden" (such 
as being included in a file). Ho on encountering a pragmat with 
this parameter* the formatter will proceed as though the name had 
been encountered in the input and will adjust indentation 
according I y. 

Omission causes no change in indentation. 

format I fmtj fi This parameter specifies formatting action after the 

pragmat is processed. Note that if there is a command on the line 

after the pragmat comment and saoarated from it by a semicolon* the 
specified action will apply to that command. 

Omission causes no change in formatting action. 

D2.3.2 UTILITY DEFINITION FILE 

The formatter maintains a table of known SCL utility names and 
terminators. The utilities initially entered into this table are! 
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D2.0 COMMAND FORMATTER 

02*3.2 UTILITY DEFINITION FILE 



Ut i I i ty Names 



Terminator Names 



ADMINSTER.USER* ADMU QUIT* QUI 

BACKUP.PERMANENT..FILES* 8ACPF QUIT* QUI 

BUILD.REAL.MEHQRY* BUIRM QUIT* QUI 
CREATE.INTERSTATE .CONNECTION* 

CREXC QUIT* QUI* DELIC* 

OELETE.INTERSTATE.CONNECTION 

CREATE.QBJECT.IIBRARY* CR^OL QUIT* QUI 

EDIT.FILE* EDIF QUIT* QUI* END 

EDIT.LIBRARYf EOIL QUIT* QUI* END 
LINK.VIRTUAL_ENVIRQNHENT# 

LIN¥£ QUIT* QUI 
MEASURE.PROGRAM.EXECUTION* 

HEAPE QUIT* QUI 

RESTQRE.PERMANENT.FILES* RSSPF QUIT* QUI 

SOURCE.CQDEJJTILITY* S C II QUIT* QUI* END 

The user may augment this table by generating a utility definition file 
and specifying that file on the formatter call* The file must consist 
of one line entries with the following "parameter list*** 

names * name \ n* This parameter specifies a list of names for one 
utility. Utility names must be unique* This parameter is 
requi red. 

terminators I terminator 5 t * This parameter specifies a list of names 
Mhich terminate the utility* 

Omission causes < quit* qui) ti he used* 

Utility names must be unique and may not be the same as any of the 
"built in" names* If the terminator names of a utility include more 
than QUIT and QUI then all terminators must be specified* 

Examples 

n={ my„uti I i ty* mu) t*( end*qui t.qu i) 
names«( your.uti I i ty* yu) 
i ts_uti I ity stop 
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02.4 QUTPUT 

02.4 oyifyi 

The formatter generates Unas in the output file according to the 
following conventions* 

1. If any input statement contains continuation lines* ail 
continuation lines mMI be read and concatenated with the 
beginning line of the statement before formatting of that 
statement begins. 

2. The "current indent column" will govern the starting column 
of the statement written to the output file. Initially the 
current indent column Hill be column 1 (unless overridden by 
the i ni ti al_i ndentjcol ymn in the command call to the 
formatter ) . 

3. If the statement to be output (starting at the current indent 
column) is of such length as to exceed the specified page 
width* then that statement will be broken at - if possible - 
a reasonable place and as many continuation lines as required 
will be generated. 

4. A continuation line will be indented six (6) columns from the 
indent column of the first line of the statement* 

5. Breaking a line at a "reasonable place** means that items 
which are closely related to adjoining items will not be 
placed on separate lines unless there is no alternative. 

6. If an expression consisting of <oper andXoper atorXoper and> 
must be broken* it * i 1 1 be broken immediately after the 
operator - or the space following the operator if one exists. 

7. In certain cases - a string too long to fit on the entire 
line* for example - indentation must be suppressed on the 
continuation line. 

8. If a statement consists of an SCL control statement which 
defines the beginning of an SCL structure block (IF* for 
example)* then all statements following such a statement will 
be indented two (2) spaces from the control statement until 
the corresponding end statement (IF£ND» for example) is 
encounter ed. 
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02.0 CQHMAND FORMATTER 
02.4 OUTPUT 



9. If a statement is labeled* the label (followed by the 

continuation ellipses) wi If be placed on a line by itself 

indented two (2) columns less than the current Indent column 

(unless* of course* the current indent column is less than 
3). 

10. SCL control statement identifiers (IF* WHILE* PROC* etc.) 
along with certain control words (DO* EXIT* etc.) will fee 
written to the output file in uppercase. All other names 
(except certain utility names I will be written in lowercase. 

11. Utilities will be treated as SCL structure blocks. 

12» SCL comments Kill be retained and written to the output file. 
Comments at the beginning of a statement (before the command 
name) nil! be written as separate lines and indented to the 
current indent column. An exception will be comments 
starting in column 1 of the Input file. Such comments will 
be written starting in column 1 of the output file. 

13. Spaces will be added or deleted as follows! 

a*. A comma will be written with no leading space and with 

a tr ai i i ng space, 
b*. The colon separating the parameter name from the 

parameter specification in a PRQC declaration will have 

leading spaces deleted and will be foil wed by a space, 
c. Contiguous spaces on input will be output as one space. 
d*. A space will precede and follow the equals sign of an 

assignment statement. 
e.. Unnecessary spaces in a parameter list will not be 

written* That is "command par_name * par_value M will 

be written as "command par_name»par_val ue**. 
f.. No rule in this sub-section will apply to characters 

inside a string or comment expression. 

14. If multiple statements (separated by semi-colons) exist on an 
input line* each statement will be formatted separately and 
the semi-colons discarded. 

13. If a statement terminator is optional (THEN of an IF 
statement* for example)* the formatter will generate the 
terminator if it does not exist on the input statement. 
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16. COLLECT.TgXT (COLT) is treated as a special case since the 
text being collected may not be SCL statements. Whenever a 
collect.text command is encountered* the parameter list is 
scanned for the value of the UNTIL (U) parameter* If the 
UNTIL parameter is not specified* or is specified as a 
literal string* formatting is turned off until the line 
containing the specified string (or **) is read. All 
collect.text lines are cooled to the output file without any 
other processing. If the UHTIL parameter is specified as a 
variable (other thnn a literal string)* formatting will not 
be turned off (since there is no way of knowing when it is to 
be re-activated) and the results may be undefined. The 
collect.text command will he output starting in column 1 with 
the command name written in uppercase. 

17. Any input line beginning with the key. char acter specified in 
the call to the formnatter will be written directly to the 
output file without any other processing attempted. 

18* If a statement formatted for output exceeds the maximum 
command size (currently 25b characters)* any indentation 
present in the cutout line(s) of the statement will be 
decremented until the maximum command size is not exceeded. 
If deleting ail indentation for the statement does not result 
in an acceptable command size* a comment will be issued to 
the output file and the input line(s) of the statement 
written instead of the formatted line(s). 

19. If a blank line does not follow the last line of a proc 
deicaration* a blank line will be added. If a blank line 
does not appear before a PROCEMO statement* a blank line will 
be added. 

20. Certain errors (such as unbalanced parentheses) are detected 
by the formatter by calls to modified versions of some SCL 
interpreter procedures. Such errors are reported to the 
output file in the format of system error messages. The 
message mode (set by set. message. mode ) wilt be reflected in 
these messages. 

21. If the formatter encounters a problem with a statement (such 
as not being able to determine the UNTIL value of 
COLLECT.TEXT)* then a warning message will be written to the 

output file as a comment. 
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22* For each error or earning message written to the output file* 
the input linets) in which the error was detected will 
immediately follow the message*' 

23* Certain information about a line in error may be retained by 
the formatter. For example* if a "WHEN" statement is 
recognized but an error is detected in some remaining portion 
of the statement* a WHEN block- will still be established and 
will require a WHENENQ statement. 

24* The formatter keeps track of SCL structure blocks in a 
somewhat different manner than the SCL interpreter. Whenever 
a statement specifying an end of a block (such as WHILEND) is 
encountered* the formatter checks that the block exists* If 
it does and if any block was started within the block being 
terminated* then a formatter error message will be generated 
indicating the line number of the statement beginning the 
block* This means that if a PROCEND statement is encountered 
(and a PRQC block exists)* then any unterminated block will 
be noted in an error message* 

25* In checking syntax and the like* the formatter assumes no 
knowledge of variable types or the like* For example* the 
statement 

IF 'this is a string* - 255(10) THEN 
will be considered to be acceptable. That is* the formatter 
will detect only the most obyious errors* 

26* A count of error and! warning messages issued will be 
maintained and reported to the status variable at termination 
of the formatter. If the error count exceeds a certain 
threshold (currently 251* the formatter will give up* feeling 
that it is probably processing unknown text* 



02.5 EXAfiELfi! 
Input* 

P r o c a a a ( 

Input*! i fi ie « $REQUIRED 

output* o : fi le»SOUTPUT 

status) 
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put. this .fnessage.out 'this is a message to be put to •« 

output* o«$output 

edlt.fi le xyz 

I § t a 

incl ude.fi I e abcc 

H $ quit 
Mhile.labels white abe>def do 
if h i j * » ? ? ? * then 
cr eate.object.l i brary 

add.saodui e I i brary* snve* abcdef ghi jkl amopqrstuvwxyzl. abcdef ghi . . 
jkl nin2 

generate.! i brary a 
qui t 

ef s e ; e x i t 
' i f endjwhi I endfprocend 

Output * 

PRQC aaa C 

input* i: file » $required 
output* oj file * $output 
status) 

put. this .message. out 'this is a message to be put to output* •• 

o»$output 
EDIT. FILE xyz 
I ♦ > a 

include.fi I e abcc 
"$ quit 
whi I e. I abet s •* 

WHILE abc > def 00 
IF hi j * »???• THEN 
CREATE.QBJECT.LIBRARY 

add.modul e I i brary s « nve* abcdef ghi jk I mnopqr stuvvixyzl* • 
• abcdef ghi jklmn2 

generate. li brary a 
QUIT 
ELSE 

EXIT 
IFENO 
tf NIL END while. I abet 

PROCEND aaa 
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E1.0 £aiI_CAIALQ£ 

El.l USIiiS_£QII_£AIALfl£ 

EDIT.CATALQG CEOIC) is a full scream utility that allows you to view and 
to manipulate the contents of NOS/VE- files and catalogs* EDIC uses the 
terminal attribute t er.mi nal_mode I to determine the screen interface* 
EDIC includes the following general activities* 

• Viewing a catalog or a file* 

• Copying a file* 

• Renaming a file within a catalog* 

• Hoving a file to another catalog* 

• Creating a new file or catalog* 

• Switching to a different catalog* 

• Deleting a catalog or a file, 
« Sorting a catalog display* 

• Locating a file within a catalog display* 

• Executl ng a file* 

• Printing a file* 

• Displaying file attributes* 
. Editing a file with FSE/V5. 

• Executing NOS/VE commands. 

El. 2 £AUIJ!i£-&&II.£AIAU3& 

The format for calling EDIT^CATALOS is as follows* 

EDIT.CATALQG (EDIC) 
£CATAL0G»catalog3 
COISf>LAY - QPTION*keyword val uel 
CN0J)0LLAR„EILES»boQ»ean,.valye1 
CSTATUS VARIABLE-status variable! 

The CATALOG (C) parameter specifies the catalog for which information is 
to be displayed* If you do not specify a catalog name* the system 
displays SCATALQG* 

The DISPLAY_0PTI0M CDO) parameter specifies how much information that 
you wish to have displayed* The dlsolay options aret 

BRIEF (8) 
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Selects a display that shows files and their cycles only* 

ALL (A) 

Selects a display that shows files and the following information 
for each file* size* processor* file type* and last changed date 

and time* 

If the QI$PLAY_Qf>TION parameter is omitted* brief is selected. 

NO.DOLLAR.FILES «NDF> 



TRUE 



FALSE 



Selects a display in which system file names 
{those beginning with a dollar sign) are not 
di splayed* 

Selects a display that shows both system file 
names and user file names* 



A sample EDIT^CATALOG call Is shown below* 

/EDIT.CATALQ6 c*$user do*al I ndf 
This entry returns a screen similar to the following sample display* 
MY.CATALOG 



ame«cycl e 



Size 
<K8) 



Processor 



File 
Type 



Changed 



Date 



Time 



Command_L ibrary*2 

Coboi_8inary 

External 



24 
9 



OClt 

Unknown 
C atal o<j 



Library 
Object 



840813 
840821 



10155 
09:41 



SPRINT \ I HOVE I JCREATEJ 5 XEC'UTS 8 J I ! Si S SLOCATES 

JVIEW J ! COPY J J £DIC S iDELITES J UNDO I i QUIT J J SORT ! SATTRIBS 

Fl fZ F3 F4 F5 F6 F7 F8 



This display shows several columns of information about files and 
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El. 2 CALLING EDIT.CATALOG 



subcataiogs within the catalog you are currently viewing. 

1* The Name .cycle column displays the names of files within the 

catalog. A file natse nay be followed by a period and a cycle 

number. If the cycle number is 1* and there is only one cycle* 
the cycle number is not displayed* 

2* The Size column shows the si.?e of the file in kilobytes* Files 
less than one kilobyte show a size of !• 

3. The Processor column shows the name of the processor that can 
handle the file* 

4* The File Type column displays the type category of the file. A 
file can be any one of four types: legible* object* library* or 
catalog. 

Legible means the file contains text that is human-readable. 
Object means the file contains compiler-generated object code. 
Library is a collection of object files. Catalog indicates a 
subcatalog of the currently displayed catalog. 

5* The Changed Date and Time column shows when the last change was 
made to the file. The date Is shown in yymmdd format. Time is 
shown in hh*mm format. If no changes have been made to a filet 
this column displays the date and time the file was created. 

Some columns may be displayed as blank if their contents cannot be 
obtained. You may receive a display with some blank columns if? 

1* You are not authorized to access the file. 

2 • The file is in use. 

3. The catalog is SLOCAL. 

E l . 3 HfliXiifi.AaQilI-.liIIilia-£llII-£ AIALOS 

When using EDIT. CATALOG* function keys enable you to move from screen to 
screen. If there are more entries in a catalog or more information in a 
file than fit on a single screen* you can see the next screen of 
Information by pressing the FtfD key. To return to the previous screen* 
press the 8KW key. When you reach the last screen of a catalog or a 
file* a message is displayed in the upper right corner of the screen 
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El. 3 HOVING ABOUT WITHIN E0IT.CATAL3G 



stating •End of Catalog* or 'End 
used for cursor positioning* 



of File', The UP and the DQiM keys are 



If your terminal does not Have function Keys* there are alternate 
characters you can use to move from screen to screen* You enter these 
characters in the first column of a line in the file display. The 
character entered determines the activity performed. Alternate 
characters and the actions performed are shown below. 



CHARACTER 


ACTION 


+ 


FWD 


- 


BKW 


/ 


DOWN 


* 


UP 


< 


BACK 


A 


ATTRIBUTE 


€ 


COPY 


D 


DELETE 


e 


EDIT 


G 


EOIC 



CHARACTER 


ACTION 


H 


HELP 


L 


LOCATE 


n 


HOVE 


N 


CREATE 


P 


PRINT 


Q 


QUIT 


S 


SORT 


u 


UNDO 


v 


VIEW 


X 


EXECUTE 



If you are using these alternate characters* key prompts similar to 
those below will be displayed instead of the function key prompts shown 
ear I i er • 

HY.CATALOG 



Name .eye I e 



S i ze 
<K8) 



Processor 



Fi le 
Type 



Changed 
Date ? Time 



Commands i brary.2 

Cobol_Binary 

External 



224 



QCU 

Unknown 

Catalog 



L ibrary 

Object 



840813 
840821 



IQ155 
09J41 



+ *FWD —BKW *»UP /=DQWN <«8ACK A»4ttrlb C«Copy D»Delete E»Edit 6»Goto 
H*HELP L*Locate N*New P = Print Q*Qu!t S»-Sort U'Undo V»View X*Execute 
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£1.4 Ili£a&!lAIiatiAL-ll£5SAfi£S- Atia.£&a'aa-DiIS£LAIS 

EDIC displays informati onai messages and error messages in different 
ways* 

1. If a message is an informational or a non-error type prompting 
message generated by EDIC*' the message is displayed on the message 
line which is one line below the home line when the home line is 
at the top of the screen and one above the home line when the home 
line is at the bottom of the screen. {There is one exception to 
this* When deleting a catalog* the informational message stating 
a catalog DELETE cannot be iJNOOne appears in a window in the 
center of the display with two function Keys labeled OK and 
CANCEL. ) 

2* If the message results from an error reported by a part of the 
system that performs user-requested functions* EDIC opens a window 
in the middle of the catalog display and shows the message there* 

e i . s Emias-£fiii_£AiAkas 

* * 

F6 > S QUIT J 

Pressing the QUIT key takes you out of E-OIT.CATALOG at any time. four 
working catalog is restored to what it was when you entered E0IC# 
regardless of which catalog you were viewing when you pressed QUIT* 

Deleted files that have not been UNOOne ^r e deleted at this time* CSee 
Undoing File Deletions later in this chapter*) If there is a problem 
with the deletion of a file* you will ha informed of the error* The 
problem file is not deleted and the deletion process continues with 
subsequent files in the delete list* 

€1*6 £ftII_£ALALlML££AIUa£5 

EDIT_CATALOG simplifies many common procedures used in file and catalog 

management. Using this utility reduces the number of keystrokes 
required and speeds processing* 
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£1.6.1 VIEWING A CATALOG OR FILS 

■f 4. 

SPRINT J 
Fl > IVIEW J 

Uben it is called* EOIC initially displays the catalog specified on the 
first parameter entered. For example* if you enter EOIC $US8R» your 
$US€R catalog is displayed* The- display contains several columns of 
information about the files and the subeatalogs within the catalog 
specified* If you omit the first parameter* you get a display of your 
current working catalog* 

If you wish to see the contents of a particular entry on the display, 
use the arrow keys to position the cursor on the line of the entry and 
press the VIEW key. If the entry selected is a file* the first screen 
of the file will be displayed on a separate screen* If the entry 
selected is a subcatalog. entries in the subcatalog will be displayed on 
the screen* 

The screens displaying the selected file or subcatalog provide key 
prompts instructing you how to nova about within the file or subcatalog* 
dressing the BACK key returns you to the previous catalog you were 
viewing or to the catalog immediately above the currently displayed 
catalog* 

£1.6.2 CREATING A NEW CATALOG OR FILE 

+ f 

F3 > \ CREATE J 

JEDIC \ 

You can create a new file or new catalog within the currently displayed 
catalog by pressing the CREATE key* After pressing the CREATE key* the 
following prompt is displayed! 

— Enter file name to create a file; name, to create a catalog 

To create a new file* enter the file name on the home line and press 
RETURN* You will be taken to the Full Screen Editor to create the 
contents of the new file* 
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If you decide not to create a ne^ file* press the BACK Key to cancel the 
CREATE. 60IC will then display the following messages 

— Creation not done 

To create a new catalog* enter the catalog name followed by a period on 
the home line and press RETURN* The following message is displayed? 

— Catalog created 

After you have created a new catalog* you can move or copy files to it* 

If you haye created a new catalog and you then decide you do not want 
the catalog* follow the instructions given in the Deleting a Catalog or 
File heading later in this chapter. 

El. 6. 3 SWITCHING CATALOGS 

* -— + 

■ {CREATES 
F3 > 



Your working catalog is the catalog ycu currently are viewing. You can 
switch and edit a different catalog by Dressing the EDIC key. You then 
see the following prompts 

— Enter catalog name to switch to 

Enter the name of the catalog yau want to edit and press RETURN* 

The catalog name you enter is treated according to the NQS/VE rules for 
catalog path names* If the name starts with a period it Is an absolute 
path. Thus* the entry *Y0UR_NA*E takes you to the path YaiJR_NAHE. 

If you enter a name without a leading period* you are referencing a 
sufeeatlog of the current catalog. For example* if you are viewing 
SSYSTEM and you enter MANUALS* you will be switched to SSYSTEH.HANUALS. 

There is* however* an easier way to access a subcataiog of the current 
catalog* Simply position the cursor on the line that contains the 
subcataiog name and press the VIEW key. 

If you decide not to switch catalogs* press the SACK key before entering 
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£1.6. 3 SWITCHING CATALOGS 

a new catalog name. The system displays the following message* 

— Catalog not changed 
El. 6. 4 DELETING A CATALOG OR FILE 

f — — . ♦ 

\ XSCUTES 

F4< > J DELETE? 

♦ ———-+ 

You can delete a catalog or file by positioning the cursor on the line 

of the entry you want to delete und pressing the DELETE key. The entry 

is highlighted and then erased from the display. However* the entry is 
not fully deleted until you exit EDIT^C ATALQG. 

If you delete an entry by mistake* you nay be able to correct the error. 
Some files can be restored by pressing the UNDO key. Multiple file 
restores are done in the reverse order in which they were deleted. Each 
tinse you press the UNDO key* the cursor position shifts to the newly 
restored file. 

Deletion of catalogs* files in SLOCAL* and files with more than one 
cycle cannot be UHOOne. tfhen you <aake these types of deletions you will 
receive the following warning* 

— Delete of a catalog cannot be UMDOne 

El. 6. 5 UNDOING FILE DELETIONS 



F5 > 






• 



File restores are done in the reverse order in which they were deleted. 

Each UNDO positions the cursor to the newly restored file (possibly 

changing catalogs to do soJ. Files are fully deleted only when you 
leave EDIT.CATALQ6. 

If no files have been deleted prior to performing an UNDO* you will 
receive the following message? 

— No deletes to UNDO 
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F5 > 



i * 

* * 

4 — 4 



You can sort entries in any one of the five columns. You can sort 
entries by* 

. Name 

* Size 

• Processor 

• File Type 

♦ Changed Date/Time 

To sort entries* press the SORT key. Each column is then numbered with 
a numeric overlay on top of the text and a prompt is displayed in the 
upper-right corner of the display. 

- Fnter number of field to sort on 



Name .cycle J Size 


? File J Changed 
! Processor ? Type J Date J Time 


4^—4 J 4 4 

ill i t *> i 

ill t 1 C 1 

4 4 * 4~ 4 


+ *•—»+ » + 4 * 4—4 

i I 'i * » I /, • • I & l 
i i 3 » t i H • t « 7 t 

; 4 4 * 4 4 | 4« 4 



Enter the number of the column by which you want to sort the display and 
press RETURN. The screen is erased and redisplayed with the entries 
sorted according to the field you chose. 

Press SACK if you decide not to sort. The system redisplays the screen 
without the numeric overlays and the following message is displayed: 

—Sort not done 
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El. 6. 7 COPYING A FILE 



4——— + 

F2 > i COPY \ 

You can copy a file by positioning the cursor over the name of the file 
you want to copy and pressing the COPY key. The file entry will be 
highlighted and you will see the following prompts 

— Enter name to copy to 

Enter the name of the destination file to which you want the original 
fife copi ed. 

The destination file name you enter can be a file name or a path name. 
If you enter a file name (or a file nane. cycle number) the copy will be 
Placed in a destination file within the catalog you are viewing* To 
copy a file to a destination file in a different catalog* you must enter 
a path name. For example* to copy a file to a destination file called 
NEW in subcataiog MINE* enter $JSER,1INE.NEW as the destination file 
name* 

A shorthand notation is provided for copying between catalogs. Type the 
path name up to and including the period preceding the name of the file 
in the destination catalog and press RETURN. EOIC assumes you want the 
file to have the same name in the destination catalog as it has In the 
current catalog. 

If you copy a file to a non-existent file* you get an exact 
byte-f or-byte copy with all the original file attributes preserved 
(except ring attributes). 

If the target of the copy exists and has different file attributes from 
the source file* a r ecord-by-record copy will be made (providing the 
attributes are compatible). 

If you decide not to copy a file* press the BACK key. The file entry is 
no longer highlighted and the fallowing message is displayed? 

— Copy not made 
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+. -.4. 

ILOCATEI 

F8 > SATTfclBS 

•f — — ™+ 

You can locate a particular file within a catalog using the LOCATE Hey. 
yhen you press this key you see the following prompt? 

— Enter name to locate 

Enter all or part of the file naie you wish to locate and press RETURN. 
If the file name is found* the cursor will move to the name of that 
file. If the file is not located* the following message appears on your 
screens 

— NOT FOUND 

A feature called "wild cards** is provided to help you search for file 
names* The simplest form of a Mild card is the question mark (?) 
character. The question mark can represent any single character in a 
file name. For example* to find all your files whose names begin with a 
character followed by BC J you would search for ?8C. The question mark 
can be used in any character position. 

Another type of wild card is the asterisk (*) character. Like the 
question mark* the asterisk can represent any character. However* the 
asterisk can represent any rumber of characters* not just one. For 
example* you enter SV* to find alt your files that begin with SV. The 
SV matches the first two characters of the file name and the asterisk 
matches the rest of the name. To find all the files with SOURCE as part 
of the name* you would enter *S3URCE*. 

For example* if you entered the following! 

?e — Enter naue to locate 

a display similar to the following would be returned. 

— Select entry with cursor and oress RETURN or press RETURN 
- Displaying located files 
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t 

t 

Name* cycle » Size 


i 

1 Processor ! 


! File 
Type 


1 Changed 
' a t e J Time 


SECHO 1 I 1 
SEftRORS I I 


! SCL 

! UNKNOWN , 


! LIST { 
LIST 





The list of located flies appears on a separate 
a particular file by placing the cursor on the 
appears and pressing RETURN* If you decide not 
press the SACK key. No message is dlsalayed* 

El. 6.9 MOVING OR RENAHING A FILi 



display. You can choose 

line where the file name 

to I ocate any f i les# 



F2 > 



f — — — ,4. 

\ >iOVi= \ 

i 



You can move a file to a new catalog or rename a file within the same 



catalog by positioning the cursor to the line where the 
displayed and pressing the MOVE key. The file entry will 
and you will see the following prompt* 



f I I e name i s 
be high! ighted 



— Enter name to move 



If you want to move a file to another catalog* enter the path 
press RETURN. The system displays the following message: 



name and 



— F fie moved 

A shorthand notation is provided for moving a file between catalogs. 
Type the path name up to and including the period preceding the name of 
the file in the destination catalog and press RETURN. EOIC assumes you 
want the file to have the same name in the destination catalog as in the 
current one. 

If you want to rename a file in the the current catalog* enter the new 
file name and press RETURN* The following message is returned! 



— F i I e renamed 
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£1*0 £DIT_CATALGG 
£1.6.9 HOVING OR Ri 



iING A FILi 



If you decide not to wove or rename a file* press the BACK key to cancel 
the operation* The system responds with the following message? 

— File not moved 
£1.6. 10 EXECUTING A FIL£ 



F7— > 



4— — ♦ 

JXHCUTS! 
DELETE! 

♦ ~- — 4- 



You can execute an SCL or object file using the XECUTE key. Position 
the cursor on the line of the file you want to execute and press the 
XECUTE key. 

The file entry is highlighted and you see the following prompt* 

—Enter parameters or press RETURN if none 

Enter any parameters you wish to add and press RETURN. Or* if you 
prefer not to supply any parameters* simply press RETURN. The program 
will then execute* During execution the screen is blank except for the 
fol I owing message* 

— Executing command 

The blank screen allows any program output to be clearly visible. 

When execution is complete* processing pauses* This pause gives you 
time to read any interactive output produced by your program before the 
catalog display overwrites it. When you have read the output* press 
RETURN to go back to the catalog display. 

If you decide not to execute a file* press the BACK key. Highlighting 
disappears* but no message is disolayed. 

El. 6. 11 EDITING A FILE 

You can edit a file using the NPS/VE Full Screen Editor CFSE) by placing 
the cursor on the line that displays the name of the file you wish to 
edit and pressing the EDIT key. You are taken automatically into the 
Fui I Screen Edi tor. 
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E1.0 E0IT.CATAL06 

El. 6. 11 EDITING A FILE 



When you are done editing the file* leave the editor in the' sane manner 
you normally use to end an editing session. You are returned to EOIC 
exactly where you left it* 

El. 6. 12 PRINTING A FILE 



Fl > 



+-■- — — -•+ 
SPRINT. I 

S VIEW I 

+ — , 4. 



You can print a file using trie PRINT key* Place the cursor on the line 
of the file you want to print and oress the PRINT Key* The entry is 
highlighted and you are asked? 

— yhat is your din number? 

Enter your bin number and press RETURN. The system returns the 
fol I owing messages 

— File sent to printer 

The file is sent to the central site line printer* 

El. 6. 13 DISPLAYING FILE ATTRIBUTES 



F8-~ > 



+• . — + 

J LOCATES 
MTTRI3S 



You can display the file attributes for a file by positioning the cursor 
on the file naie line and pressing the ATTRIB key* You will then see a 
separate display similar to the one shown below* This display shows the 
most frequently referenced file attributes* 

— File attributes of SHYFILE 



Fi le.organizationt SEQUENTIAL 
8 lock. types SYSTEM.SPECIFIED 
Haximum_record«J engthi 256 
Access.mode: READ APPEND 
Open.pos it ions $801 



Sizes 1312 

Record.types VARIABLE 
Haximum.r ecord_l engths 
Max imuffl_b lock_l engths 18 
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E1.0 £OIT_CATALOG 
£1.6,13 DISPLAYING FILE 


ATTRIBUTES 






Fl ISEEALLI F2 1 J 








* i * 
F3 t 1 F* J 


• i 

! F5 J 


J F6 \ Quit \ 



When the new set of function keys appears at the bottom of the screen* 
press the SSEALL key if you wish to see a pageable display of all of the 
file's attributes. Pressing the BACK key returns you to the main 
catalog display. Pressing QUIT takes you out of E9IC* 

£1.5.14 EXECUTING NOS/VE COMMANDS 

You can execute NOS/VE commands by moving the cursor to the Home line 
and typing the comiand preceded by a slash. For example* to display the 
current working catalog* enter the following command J 

/DISC ^CATALOG 

After typing the command information* press the RETURN key. During 
execution the screen is blank except for the following message: 

— Executing command 

The blank screen allows any system response to the command to be clearly 
visible. 

When execution of the command is complete* press RETURN to restore the 
current catalog display. 
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The NOS/VE Dump Analyzer is a N3S/VE -.utility provided to aid in the 

analysis of NQS/VE system failures and Cyber 180 hardware failures* The 

Dump Analyzer accesses a tape created by the Express Deadstart Dump 

(£00) deadstart utility* The NVE subsystem may also produce a dump tape 
in the event of a NQS/VE failure. This tape is compatible with tapes 

produced by £00 and is therefore acceptable as input to the dump 
anal yzer • 

You may use the dump analyzer either interactively or run from a 
procedure or an INCLUDE.FILE as part of a batch or interactive job* The 
dump analyzer is implemented as a command utility. Subcommands are 
available to display the foil owing i nf or mat i on J 

1* Central memory* displayed in numeric and ascii format* accessed in 
virtual or real address mode. 

2. Peripheral processor memory. 

3. Maintenance registers for the IOU* memory and processors. 
%• Formatted display of exchange packages. 

5. Process information resulting from an analysis of stack segments. 

Fl.l AfiU.a-iAttALIZ£.Qli!!£l 

Purposes The ANALYZE^DUMP command invokes the dump analyzer utility. 

Format: ANALYZE.DUHP 

dufflp_.fi le « file reference 

restart.fi le * file reference 

debug.tabie * file reference or keyword value 

title « string 

output « file reference 

status * status variable 

Parameters: dump_file (df) 

Specifies the dump to be analyzed. There is no default for 
this parameter. If omitted* it is assumed that the restart 



SOFTWARE RELEASE BULLETIN 

NQS/VE Rl*l*2 LEVEL 630 
HQS/VE Dump Analyzer 

F1.0 NQS/VE DUNP ANALYZER 
Fl.l ANAO CANALYZE_DUNP> 



Fl-2 
85/03/29 



file contains the dump information* If dump_.fi le is 
omitted and the restart file is empty or non-existent* an 
error status is returned* 



res tar t.f i i e i rf ) 

The restart file is either an input file or an output file* 
depending on whether the dump.fi le parameter is specified* 
If dump.fi le is specified* a restart file is written to 
this file.This file is accessed during the execution of the 
dump analyzer* If you do not specify a dump.fi le parameter* 
the restart file indicates a file created from a dump by a 
previous execution of the analyze. dump utility. If you do 
not specify this parameter * the value $1 ocal •restart.f He 
to be used* 



debug. table <dt> 

Generates symbolic names from addresses and addresses from 
symbolic names* This table is built xhen the system is 
generated* It is included in the generated system and is 
also saved on a file* If the dump is being analyzed on the 
same system bs the dumoed system then the debug table in 
the running system may be used* Otherwise* specify the 
file name of the File saved from the system generation* 
Specify the Keyword "none" if no debug table is to be 
accessed. If you do oat specify this parameter* the running 
system debug table is used* 



title it) 

A str i ng of 
included in 



1 to 15 characters may be specified and 
the page headers if these headers are 



is 



generated. If you do not specify this parameter* the 
string »ANALYZ£.DUHP Version 1.0 1 Is used. 



output (o) 

Establishes the default outout file for all subcommands. 
This default may be overriden with the output parameter on 



fl-3 

SOFTWARE RELEASE BULLETIN 

815/03/29 
N0S/V6 Rl.1.2 LEVEL 630 
NGS/VE Dump Analyzer 

F1«0 NOS/VE DUMP ANALYZER 
Fl.l ANAQ UNALYZE.DUMP) 

each subcommand* If you do not specify this parameter* the 
value Soutput is used* 

status 

Optional status variable* 

Remarks J Analyze dump does not request a tape. You must supply the 

REQU£ST_HAGN£TIC TAPE command prior to invoking ANALYZE 
DUMP, 

Examples It equest_magne t ic.itape $!ocai*dufflp type*mt9$6250 •• 

evsn* i diiip001 v 
/ anal yze_dump dump.f I I e*$l ocai *duipp restart_f i ! e*«« 

$user«dmp001 
ad /qui t 

/anal yze.duaip rf "Suser •dnpOOl 
ad/ 

Fl*2 aUHE-AliALIIER-SUfiCLflflilAliaS 

The following subcommands are described in this section! 

CHANGE.OEFAULT (CHAD) 

CHANGE.PRQCESSOR.REGISTER (CHI APR) 

CQPY.HEMQRY (CQPH) 

COPYJPP.MEMQRY (COPPfi) 

OISPLAY_CALL (DISC) 

DISPLAY_EXCHANGE_PACKAG£ (OISEP) 

OISPLAY..HAINTENANCE.REGISTERS (OISHR) 

OISPLAY.HEHORY (OIS..) 

DISPLAY_PP_MEHQRY (DlSPfl) 

QUIT (QUI) 
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Fl.2.1 (CHAD) CHANGE.DEFAULT 

Purpose^ This subcommand allocs you to change the default setting of 
certain parameters on dump analyzer subcommands* 

Format: CHANGE .DEFAULT 

exchange * integer or keyword value 

processor » integer 

bytes ■ integer 

address_mode * keyword value 

words ■ integer 

status * status variable 

Parameters! exchange I e ) 

If you specify this parameter* the value supplied is used 
as the default setting for all subsequent subcommands and 
functions which accept the exchange parameter* Allowable 
values are the key words monitor* m» job* j or an integer 
value* If this parameter is not specified* the default is 
not changed* 

processor (pJ 

If you specify this parameter* the value supplied is used 
as the default setting for all subsequent subcommands and 
functions which accept the processor parameter* Allowable 
values are integers between and 3* If this parameter Is 
not specified* the default is not changed. 

bytes ib) 

If you specify this parameter* the value supplied is used 
as the default setting for the bytes parameter on the 
DISPLAY_M£MORY subcommand. Allowable values are integers 
between and 33554432* If you do not specify this 
parameter* the default is not changed. 
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address^mode C am) 

If you specify this oarafetsrt the value supplied is used 
as the default setting for all subsequent subcommands and 
functions which accept the address.mode parameter* 
Allowable values are the Keywords process_vi rtua l_addr ess* 
pva* sy$tem_vi rtual M .addre$s» sva# real.memor y.address and 
na. If you do not soecify this parameter* the default is 
not changed* 



words <w) 

If you specify this parameter* the value supplied is used 
as the default setting for the words parameter on the 
DISPLA¥_fP_HEMORY subcommand. Allowable values are 
integers between 3 and 4096. If you do not specify this 
parameter* the default is not changed* 



Status 
Optional status variable* 



Ex amp I e» 



ad/change.def aul t e*moni tor 
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Fl.2.2 CHAPR tCHANGE_PROC£SSQRJ*EGI$TER) 

Purposet This subcommand allocs you to change the setting of the 

processor registers ahich are used for virtual address 
translation* These registers are initialized in the dump 
analyzer from their settings in the processor maintenance 
regi st ers* 

Formats CHANGE.PROCESSQR.REGISTER 

job_process_state * integer 
moni to reprocesses tat e * integer 
page.s i ze.mask s integer 
page.t abl e^address - integer 
page_tabl e_l ength * integer 
processor * integer 
status * status variable 

Parameters! job_process_st ate Cjs>s) 

Subcommands and functions which use the exchange parameter 
can obtain a real men or y address from the maintenance 
registers to use as the location of the exchange package* 
This occurs if the exchange parameter is equated to either 
job or monitor* When equated to job* the value of the jps 
register is used as the exchange address. 

The jps parameter allocs you to change the value that is 
used when the exchange parameter is equated to job* 

moni tor_pr ocess_st ate (mps) 

The mps parameter allows you to change the value that is 
used when the exchange parameter is equated to monitor* 

page.s i ze_mask <psml 

The page size mask correlates directly to a page size* The 
following table shotts the allowable values for page size 
mask and the resulting page size* 
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page size mask 



7f 1161 

7e(16 
7c(16 
78(16 
70(16 
60C16 
40(16 




sage size (bytes) 

512(101 

1024(10) 

2048(10) 

4096(10) 

8192(10) 
16384(10) 
32768(10) 
65536110) 



For this subcommand* enter the page size mask setting* not 
the page size. 



page_tabl e.address (ota) 

The page table address is specified as the actual reai 
memory starting address of the page table* 



page_t abl e_length Cot!) 

The following table stints the allowable values for page 
table length register and the resulting page table length: 



page table length register 



i 

3 3 

7 7 
Of (16) 
lf(16) 
3f(16) 
7f(16) 
Off (16) 



page table length (bytes) 



4C96 

8192 

16384 

32768 

65536 

131072 

262144 

524288 

1048576 



(10) 
(10) 
(10) 
(10) 
(10) 
(10) 
(10) 
(10) 
(10) 



For this subcommand* enter the setting of the page table 
length register* not the actual page table length* 



processor (p) 



Fl-8 

SOFTWARE RELEASE BULLETIN 

85/03/29 
NOS/VE RI.1.2 LEVEL 630 
NQS/VE Dump Analyzer 

F1.0 NQS/VE DUHP ANALYZER 

Fl.2.2 CHAPR (CHANGE. PftOCESSOR.R6GIST6R) 

The processor parameter specifies ahich processor is to fee 
selected for the subcommand in a multi-processor 
envi ronment* 

Allowable values are through 3« Omission causes to fee 
used. 

Status 

Optional status variable* 1 ' 

Example! ad/change_pr ocessor.r eg! s ter jps»4d4420< 16) 
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Fl*2*3 CQPH (COPY.HEHORY) 

Purposes Copies central merory to a file* The address of the memory 

to be copied can be specified as a process virtual address 
(pva)* a system virtual address <sva) or as a real memory 
address (rma). The memory is copied exactly as it exists In 
the dump. 

Formats CQPY.MEHORY 

address « integer 

file * file reference 

byte_count * integer 

exchange * integer or iceyMord value 

processor * integer 

address... mode » keyword value 

status » status variable 

Parameterss address (a) 

Specifies the address of the memory to be copied* Its 
format depends on the value supplied for the address_mode 
parameter* 

This parameter is required. 

fi le (f ) 

Specifies the file to ^hich the memory is copied* 

This parameter is required* 

byte_count (be) 

Indicates the number of bytes to be copied* 

If you do not specify this parameter* a default value of 
100000(16) bytes is used* 
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exchange (e) 

Designates the exchange package to be used to define the 
virtual address. An integer value is Interpreted as the 
starting real memory address of an exchange package. 

The following keywords may also be used* 

Active (a) 

indicates that the contents of the CPU at the time of 

the dump are to be used. 

Monitor (m) 

indicates that the processor maintenance registers are 
to be accessed and the value in the HPS register be 
used as the real memory address of the exchange 
P ackage. 

Job (jl indicates that the processor maintenance 

registers are to be accessed and the value in the 

4PS register used as the real memory address of the 
exchange package. 

If you do not specify C0PY,J1£M0RY# the active exchange 
package is used. 



processor <p) 

Specifies which processor is to be selected for the 
subcommand in a .mil! t {--processor environment. The processor 
determines which set of maintenance registers are to be 
used for virtual addressing parameters page size mask* page 
table address and page size mask. In addition if job or 
monitor is specified for the exchange parameter* the jps or 
mps register for that processor will be accessed. If 
active is specified for exchange* the processor parameter 
determines which processor's active exchange package is to 
be used. 

Allowable values are through 3. If you do not specify a 
parameter* a default value of is used. 
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address_mode Cam) 

Determines the Interpretation of the address parameter* 
Possible settings ares 

process_virtuai. address Cpva) causes interpretation as 
follows? 

sssnnnnnnnnC 161 with s being the segment 

number and n the offset* 

system.vi rtua l_address (sva) causes interpretation as 
f o I lows: 

aaaannnnnnnn(16) with a being the assigned 

segment identifier (asid) and 
n is the offset. 

real.tBemory.adclress (ma) specifies the starting real 
memory byte address to he copied* 

If you do not specify this parameter* a default of process,, 
y i rtual_addr ess is used. 

Status 

Optional status variable. 

Remarks* COPY_M£MORY is useful for determining which portion of 

virtual memory is Paged in by copying the memory to file 
$nul I « 

Example: ad/copy_memory a*300000000(16) f »$user .segment_3 •• 

bc«10000(16> 
ad/copm 9000U0000C 16) InuM 30000(16) 

—WARNING— Virtual memory from offset 0(16) to QFFFU6) 
is paged out. 

— WARNING — Virtual memory from offset 2000(16) to 
1FFFFM6) is paged out. 
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WARNING — Not all memory requested *as copieds a page 
fault was encountered* 
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Fl.2.4 COPPH <COPY.PP_HEHQRY) 

Purpose! copies peripheral processor memory to a file* 



Format* Copy_pp_memory 

PP^number * integer 
file * fiie reference 
address * integer 
**or d_count * integer 
status ~ status variable 



Parameters s pp.numfoer ipn) 



Specifies the number of the peripheral processor whose 
memory is to be copied to a file. 

This parameter is required. 



fi ie Cf ) 

Specifies the file to tfhich the memory is copied* 

This parameter is required. 

address <a) 

Specifies the starting address in pp memory of the copy. 

If you do not specify a value for this parameter* a default 
value of is used. 

word_count iwc) 

Indicates the number of *ords to be copied. 

If you 6o not specify a value for this parameter* a default 
value of 4096 *ords (the entire pp) is copied. 

status 



SOFTWARE RELEASE BULLETIN 



NQS/VE Rl.1.2 LEVEL 
NOS/VE Dump Analyzer 



Fl-14 
85/03/29 



F1.0 MOS/VE DUHP ANALYZER 
Fl*2.4 COPPH (COPY.PP.MEHORY) 



£ x a?a p I e i 



Optional status variable. 
ad/copy.pp.«emory 4 f**ussr«pp_4 
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Fl.2.5 DISC CDISPLAY.CALLJ 

Purpose? The DISPLAY^CALL subcommand produces a formatted display of 
the dynamic call chain for a selected task. 

Formats OISPLAY.CALL 

exchange » integer or keyword value 

processor * integer 

count a integer or keyword value 

start * integer or keyword value 

display_option » list of keyword value 

title ■ string 

output * file reference 

status ■ status variable 

Parameters $ exchange (e) 

Designates the exchange oackage to be used for the 
analysis* The exchange oackage defines the process whose 
call chain is being displayed. An integer value is 
interpreted as the starting real memory address of an 
exchange package. 

The following keywords sriay also foe usedt 

active (a) indicates that the contents of the 
processor at the time of the dump are to be used. 

monitor Cm) indicates that the processor maintenance 
registers are to be accessed* and the value in the HPS 
register used as the real memory address of the 
exchange package. 

job Cj) indicates that the processor maintenance 
registers are to be accessed and the value in the JPS 
register used as the real memory address of the 
exchange package. 

If you do not specify this parameter* the active exchange 
package is used. 
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processor (p) 

Specifies which processor is to be selected for the 
subcommand in a multi-processor environment* The processor 
determines which set of maintenance registers bt^ to be 
used for virtual addressing parameters* page table address* 
and page size mast* In addition* if job or monitor is 
specified for 0ISP1AY.CALL (disc)* the exchange parameter 
(the jps or mp s register for that processor) will be 
accessed* If active is specified for the exchange* the 
processor parameter determines which processors active 
exchange package is to be used. 

Allocable values are through 3. If you do not specify a 
value for this parameter* a default value of is used. 



count (c) 

Number of stack frames to be displayed or the Keyword* 
"all". If the value given is greater than the number of 
existing frames* all ^re displayed* 

If you do not specify this parameter* the entire call chain 
is displayed. 

s t ar t ( s ) 

The start parameter indicates which frame in the call chain 
will begin the display. Frame one represents the most 
recent call or trap. Start may also specify the keyword 
£XCHANGE_PACKAGH« This begins the display with a formatted 
display of the exchange package* and then displays stack 
frames starting with one. 

If you do not specify this parameter* the keyword "exchange, 
package*' is used. 



di spl ay.opti ons ( di spl ay.opt I on* do) 
The following display options are provided! 
brief (b) - provides a minimum display. 
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full Cf) - provides a isore detailed display* 

save (s) - displays the contents of the stack frame 
save area in hexadecimal interpretation* 

You can use a list of keywords* but full and brief cannot 
foe used together. 

If you do not specify an option* a dispi ay.optl on default 
of brief is used* 

Title Ct) 

Specifies a string of 1 to 31 characters which is included 
in the page headers if these headers are generated. 

If you do not specify a title* the string f d isp I ay_cal I » is 
used* 

Output Co) 

File receiving the disolay. If you do not specify an out 
put file* the value specified on the ANALYZEJ3UMP command 
output parameter is used* 

Status 

Optional status variable* 

Examplet ad/di sp lay_cal I e»job 

Exchange address • 5C54A0(16) 

Exchange package: PR3C£-SS,CrWHAND_INJLIST ♦ AQC16) in 

CLMSPRQCESS.COMHAMDS 

monitor conditions? page table search without find 

Frame 1* CLP$PRQCESS_CQM«AN9 ♦ 682(16) in CLHSPRGCESS JCQHMANDS 
Frame 2J PROCESS.COMHAND + 100(15) in CLHSINCLUDE 

The on condition flag is set for this frame* 
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Frame 3* PRQ€£SS_€0HHAMD_LIH5 + 550Q6) in CLNSINCLUDE 
Frame 41 CLPSSCAN.CQMHANDJLINE «■ AEC16) in CLHSIHCLUOE 
Frame 5* P * 8 42 684 2C 

Frame 6* P = B 42 6CE82 

Frame 7? P « 8 42 6D8 40 

The critical frame flag is set for this frame. 

The on condition flag Is set for this frame. 
Frame 8J P » 8 42 5E3F4 

The critical frame flag is set for this frame. 

The on condition flag is set for this frame. 
Frame 9s PHPSORIGINAL.CALLER ♦ 186(16) in PHMSOUTWARD_CALL 

The critical frame flag is set for this frame. 

The on condition flag is. set for this frame. 

Display terminated* end of call chain encountered in 

frame 9 
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1=1.2. 6 DISEP (DISPLAY.EXCHANGE.PACKAGE) 

Purposes The purpose of the DISPLAY.EXCHANGE.PACKAGE subcommand is 
to produce a formatted display the contents of a selected 
exchange package. 

Formats Di sp I ay_exchange_.p ackage 

exchange * Integer or keyword value 

processor * integer 

title * string 

output « file reference 

status » status variable 

Parameters* exchange <e) 

The exchange parameter designates the exchange package to 
be interpreted. An integer value is interpreted as the 
starting real memory address of an exchange package* 

The following keywords may also be used: 

Active (a) indicates that the contents of the CPU at 

the time of the dump are to be displayed* 

iionitor <m) indicates that the processor maintenance 
registers are to be accessed and the value in the MPS 
register used as the real memory address of the 
exchange package* 

Job (j) indicates that the processor maintenance 
registers are to be accessed and the value in the JPS 
register used as the real memory address of the 

exchange package* 

If you do not specify this parameter* the active exchange 
package is displayed* 

processor (p) 

The processor parameter specifies which processor is to be 
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selected for the subcommand in a nut ti— processor 
environment* The processor determines which set of 
maintenance registers are to be used for virtual addressing 
parameters page size mask* page table address and page size 
mask* In addition if job or monitor is specified for the 
exchange -parameter'.* the jos or mps register for that 
processor will be accessed. If active is specified for 
exchange* the processor oaraneter determines which 
processor's active exchange package is to be used. 

Allowable values are through 3. If you do not specify 
this parameter* a default value of is used* 



Title (t) 

A string of I to 31 characters may be specified and is 
included in the page headers if these headers are generated. 

If you do not specify this parameter* the string 'display, 
exchange. package* is used. 

Output (o) 

Indicates the file receiving the display* If you do not 
specify this parameter* the value specified on the ANALYZE. 
DUHP.COHMAND output parameter is used* 



Status 

Optional status variable. 



Examples ad/dl sp I ay. exchange. package e = job 
Exchange address * 5C54A0(16) 

Exchange package* PROCESS. COMHAND.IN.LIST ♦ A0U6) in 

CLM$PR0C£SS_C0H*1A^0$ 

monitor conditions? page table search without find 

GOOD P 8 10 3F450 
vmid/uvmid 0030 AO. 8 4 3890 
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fiags/te 0032 A 8 4E 3970 

user mask F?7 42 8 Ag 3908 

monitor mask FFFC A3 8 IB 5858 

ucr 0030 A4 8 4£ 3890 

mcr 00*0 A5 B A£ 39F8 

kypt cl/lpid 0090 A6 8 5 18520 

kypt mask 0000 A7 F FFF -80000000 

kypt code 0000 A8 8 5 18520 

0000 A9 8 5 18520 

pit 7FF1 AA 8 AE 2C50 

52AF A8 8 A£ 3A68 

base const 0000 AC 8 4E 39F7 

54A0 AD 8 AE 2C50 

md flags 0000 AE B F 

Stl 006 A AF B At 3F17 

XO 0000 0000 0000 0003 

XI 0000 0000 0000 0000 

X2 0000 0000 0000 0001 

X3 0000 0000 0000 

XA 0000 DODO 0000 

X5 0000 0000 0000 0000 

X6 0000 BOAS 0000 2C50 

X7 0000 0000 OCOO 0000 

X8 0000 DODO 0000 0018 

X9 0000 0000 0000 0000 

XA 0000 0000 0000 G06A 

X3 0000 0000 0000 076C 

XC 0000 0000 0000 005A 

XD 0000 0000 0000 OOFA 

XE 0000 0000 0000 0001 

XF 0000 0000 0000 0008 

md *ord 0000 0000 0000 0000 

sta OOSC utp 1 FFF 7FFFFFFF 

5 880 trao IE 

dO Ind/nask 0000 db list F FFF -80000000 

max ring OOOF to.s 1 

0000 tos 2 

0000 tos 3 

0000 tos * 

0000 tos 5 



1 


F 





2 


10 





3 


11 
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Fl.2.7 DISMR <DISPLAY_«AINTENANCE_REGISTERS) 

Fl.2.7 DISHR <DISPtAY_NAINTENAMCEJ*EGI$T€RSI 

Purpose? Displays the contents of the processor maintenance 

registers* iou maintenance registers or memory maintenance 
registers* 

Format* DISPLAY_MAINTENANC£_R£GISTERS or 
DISPIAY.MAINTENANCS REGISTER 
element » list of Keyword value 
title « str i ng 
output * file reference 
status » status variable 

f 
Parameters! element (elements* e) 

Specifies the elements **hose maintenance registers are to 
be displayed* Possible values are* 

Processor Co) 

input.output.uni t (iou) 

memory Cm ) 

al I (a) 

If you do not specify an element for this parameter t the 
registers from all elements are displayed* 

Title Ct) Specifies a string of 1 to 31 characters which is included 
in the page headers if these headers are generated. 

If you do not specify a title* the string "display, 
maintenance.regist ers** is used 

Output (o) Specifies the file receiving the display* If you do not 

specify an output file* the value specified on the ANALYZE, 
OUMP.CQHHAHO output parameter is used* 
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Status 

Optional status variable. 
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ICE.REGISTERS) 
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status summary 

bit 59 t summary status 

element id 
elements IOU 
model J 835 

s / n i 0633 
options Inst al led 
fault status mask 
os bounds 

dependent env control 
status reg 
fault status 1 
fault status 2 
test mode 
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Purposes Displays central memory in- numeric or ascii format* The 

address of the menory to be displayed can be specified as a 
process virtual address Cpva)# a system virtual address 
<sva) or as a real memory address <rmaJ* 

Formats Di sp I ay„memory 

address * integer 

bytes * integer 

exchange * integer or keyword value 

processor * integer 

address_mode * keyword value 

di spl ay_opt i on » list of keyword value 

t i t i e * string 

radix » integer 

output - file reference 

status • status variable 

Parameters! Address <a) 

Specifies the address of the memory to be displayed* Its 
format depends on the value supplied for the ADDRE5S_HQDE 
parameter* 

This parameter is required* 

Bytes (b) 

This parameter indicates the number of bytes to be 
displayed* If you do not specify a value for this 
parameter* eight is used* 

Exchange (e) 

Designates the exchange package to be used to define the 
virtual address* An integer value is interpreted as the 
starting real memory address of an exchange package. 

The following keywords may also be used* 
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o Active Ca) - Indicates that the contents of the CPU at 
the time of the dump are to be used* 

o Hon! tor Cm) - indicates that the processor maintenance 
registers are to be accessed and the value in the UPS 
register be used as the real memory address of the 
exchange package* 

o Job Cj) - indicates that the processor maintenance 

registers are to be accessed and the value in the J PS 

register be used as the real memory address of the 
exchange package* 



If you do not specify an exchange package* the active 
exchange package is used* 

processor <p) 

Specifies which processor is to be selected for the 
subcommand in a iau 1 1 1— processor environment* The processor 
determines which set of maintenance registers are to be 
used for virtual addressing parameters page size mask* page 
table address and page size mask* In addition* if * job or 
monitor is specified for the exchange parameter* the jps or 
mps register for that processor Mill be accessed* If 
active is specified for exchange* the processor parameter 
determines which processor's active exchange package is to 
be used* 

Allowable values are 3 through 3* If you do not specify a 
value for this parameter* Is used* 

address_mode (ami 

Determines the interpretation of the address parameter* 
Possible settings ares 

o pfocess.virtual.a4dress Cpva) - causes interpretation as 
f ol lows: 

sssnnnnnnnnC 16) 
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*iih s toeing the segment number and n the offset* 

o system.vi rtual .address Csval - 

aaaannnnnnnn (16) 

a is the assigned segment identifier (asid) and n is the 
offset* 

o real_menory_address (ma) - Address specifies the 
starting real memory byte address to be displayed* 

If you do not specify n value for this parameter* process. 
vi rtua I .address is used. 



Di spl ay.opti on (do) 

Al iowab le values: 

o numeric (n) - displays the numeric representation of the 
requested memory* The interpretation of the memory 
siepetMis on the radix parameter* 

o Ascii (a) - displays the ascii characters represented* 



If you do not specify a value for this parameter* numeric 
and ascii are displayed together* 

Title (t) 

Specifies a string of 1 to 31 characters which is included 
In the page headers If these headers are generated. 

If you do not specify a title* the string *disp I ay^memory • 
is used* 

Radix ( r ) 

Determines ho* the numeric data will be interpreted and 
displayed* Any integer between 8 ^nd 16 may be specified. 
If the radix is 16. • each byte of memory is interpreted as 



Fl-29 

SOFTWARE RELEASE BULLETIN 

85/03/29 
NOS/VE Rl.1.2 LEVEL 630 
NQS/VE Dump Analyzer 

Fi.O NOS/VE DUMP ANALYZER 
Fl.2.8 OISPLAY.HEHORY CDISHI 

an 8 bit unsigned integer. If the radix is 8* the byte 
count is rounded! up to the nearest number of words (8 
bytes) and the address parameter is adjusted down to the 
nearest word boundary. Each word is then displayed as an 
unsigned integer. For ail other radixes* the bytes 
parameter is adjusted to display an integral number of 8 
byte entities* Each 8 bytes is displayed as a signed 64 
bit integer. 

If you do not specify a value for this parameter* 16 is 
used. 

Output Co) 

File receiving the display. If you do not specify an 
output file, the value specified on the output parameter on 
the anafyze.dump command is used. 

Status 

Optional status variable. 

Example: ad/di sp »ay_memory a s 300Q09000<16) 20<16) e*j 

00000000 4142 4147 2454 3253 5F35 2C20 2020 2020 ABAG$TRS_5 
00000010 2020 202D 2020 2020 2020 2020 2020 2020 
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Fl.2.9 DISPLAY. PP^EMORY <DISPm 
Purposes 



This subcommand displays the contents of peripheral 
processor memory* 



Formats 



OISPLAY.PP.HEHORY 

PP_number * integer 

address * integer 

words » integer 

d i sp i ay_opt i on * list of keyword value 

radix « integer 

di spl ay.rei ocatiorv_r egi s ter « boolean 

title * str i ng 

output * file reference 

status * status variable 



Parameters? pp_number Ipn) 



Specifies pp whose contents are to be displayed* Allowable 
values are integers front to 25. An error status is 
returned if the pp specified is not present in the dump. 

This parameter is required. 

address Ca) Specifies the starting address of pp memory to 
be displayed. Values of through 4095 are allowed. 

If you do not specify a value for this parameter* a value 
of is used* 

words (m) 

This parameter specifies the number of words of pp memory 
to be displayed. Values of through 4096 are allowed. 

If you do not specify a value for this parameter* a value 
of 4096 is used. 

di spl ay_opt i on Cdol 

Specifies either numeric Cn) display* ascii <a) display or 

both. 
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If you do not specify 
ascii are displayed* 



a display option both numberie and 



radix ( r ) 

Determines how pp memory is displayed* If the radix is 
eight* and the most significant 4 bits of a word are zero* 
the word Mill be displayed with 4 octal digits* If these 
bits are non-zero* 6 octal digits will be used* With any 
radix* a word of all zeros will be displayed with hyphens 
<-)• The radix used to display the memory will also be the 
radix used to display the address of the memory being 
di sol ayed* 

di spi ay_reiocat ior^^r agi ster { drr ) 

Indicates whether or not to display the contents of the 
PP»s relocation register along with the memory display* 
The parameter is tvpe boolean the default is to display the 
register if the entire contents of the the pp*s memory is 
also being displayed* If only a portion of the op # s memory 
is being displayed then the default is to not display the 
relocation register* 

Ti tie <t) 

Specifies a string of 1 to 31 characters which is included 
in the page headers if these headers are generated* 

If you do not specify a title* the string • d isp I ay_pp_ 
memory pp_number- f * concatenated with the pp number being 
displayed* is used 

Output Co) 

File receiving the display* If you do not spescify an 
output file* the value specified on the output parameter on 
the anal yze^dump command is used* 

Status 
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Ex am pi et 
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QUIT (qui) 

Purposes Terminates the analyze dutap utility* 



Format? quit 

status * status variable 

Parameters* Status 

Optional status var i ab I s. 
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Fl . 3 Btf ttR_A!4ALXL£&-£UHi£IIfl!iS 

The fol lowing functions are provided* 
SHAINTENANCE.REGISTER < $HR ) 

SMEMORY (SHEW) 

$HEMORY.STRIHG UMS) 

$HODULE 

SOFFSST ($OFF) 

$PP_MEHORY <$PH) 

$PRQCESS_REGISTER (*PR> 

$REAL_NEMORY i%m) 

$REAL_^EMQRY_AO0RE$S C$RMA) 

$RING 

$SECTIOM ($S£C) 

$SEGHENT <SSEG) 

$SYHBQL_ADDRESS <$SA) 
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Fl.3.1 $HAINTENANCE.R€GISTER <$HR) 

Purposes Returns the contents of the specified maintenance 

register. The result is type integer* 

Formats $HAINT£NANC£_REGISTER<regi ster> element* processor) 

Parameters i register 

Specifies the register whose contents are to be returned as 
the function result. It nay be either a keyword or an 
integer. Allocable keywords are HQNITOR.PROCESS.STATE 
(HPS) and JQB.PR0:«!S3. STATE UPS). Allowable integers are 
any valid register number. 

This parameters is required, 

el enent 

Specifes nhich sat of maintenance registers are to be 
accessed. Allocable values are processor <p)» INPUT^OUTPUT, 
UNIT <iou)t and memory CiO • 

If you do not specify a value for this parameter* processor 
is used. 

processor 

Specifies the number of the processor to be used for 
processor maintenance register access. 

If you do not specify a value for this parameter* a value 
of is used. 



Remarks* An error status is returned if the register is not 
contained in the dump* 

Examples ad/disv $HAINTEHAMCE.RESIST5RC41(16n 
269000(16) 
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Fl.3.2 $HHHQRY <$MEi1) 

Purpose* Returns the contents of central memory* The result is type 
integer* 



Format^ 



$M€MQRY( address* byte.count* exchange* processor* address, 
mode ) 



Parameters* 



address 

Specifies the address whose location is to be returned as 

the result of the function* 

This parameters is required* 

byte. count 

Specifies the number of consecutive bytes which const! tues 
the value returned by Smemory* The minimum is one byte and 
maximum is eight* 

If you do not specify a value for this parameter* a value 
of six is used* 

exchange 

Designates the exchange package to be used to define a 
process virtual address* It may he specified as an integer 
or as a keyword* An integer value is interpreted as the 
starting real memory address of an exchange package* 

The following are allocable keywords* 

o Active (a) - indicates that the contents of the CPU at 
the time of the dumo are to be used* 

o Monitor Cm) - indicates that the processor maintenance 

registers are to be accessed and the value in the MPS 

register be used as the real memory address of the 
exchange package* 

o Job (j) - indicates that the processor maintenance 
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registers are to be accessed and the value In the JPS 
register be used as the real memory address of the 
exchange package* 



If you do not specify a value for this parameter* the 
active exchange package is used. 

processor 

Specifies the number of the processor to be used for 
maintenance register access* to obtain an exchange package 
address or to locate an active exchange package* 

address. mode 

This parameter determines the interpretation of the address 
argument. Possible settings aret 

o PRQCESS.VIRTUAL.ADDRESS <PVA) - causes interpretation as 
fol I ovist 

sssnnnnnnrmt 161 

*i th s being the segment number and n the offset. 

o SYSTEH.VIRTUAL. ADDRESS <$VA) - 

aaaannnnnnnn C16 } 

a is the assigned segment identifier <asid) and n is the 
offset. 

o . R£AL_HEMORY_ADDRESS CRHA) - Adress specifies the 
starting real memory byte address to be displayed. 

If you do not specify a value for this parameter* process. 
vi rtua I .address is used. 



Example: ad/disv Smemor y<8* 8. m« 0* pva) 

4OG3200O64007CFOQ6J 
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Fl.3.3 $*£HORY_STRING <$NS) 

Purpose: Returns the contents of central memory. The result is type 
string. 

Format* $NEMORY_STRING{ address* byte_count# exchange* processor* 
address.mode) 

Parameters* address 

Specifies the starting address of central memory to be 
returned as the result of the function* 

This parameter is required* 

byte.count 

Specifies the number of consecutive bytes which const! tues 
the value returned by $HEHQRY. STRING. The minimum is zero 
bytes and maximum is 2:56. 

If you do not specify the value of this parameter* a value 
of one is used. 

exchange 

Designates the exchange package to be used to define a 
process virtual address. It may be specified as an integer 
or as a keyword. An integer value is interpreted as the 
starting real memory address of an exchange package* 

The following are allocable keywords* 

o Active (a) - indicates that the contents of the CPU at 
the time of the dumo are to be used. 

o Honitor Cm) - indicates that the processor maintenance 

registers are to he accessed and the value in the MPS 

register used as the real memory address of the exchange 
package* 
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o Job ij) - indicates that the processor maintenance 
registers are to be- accessed and the value in the JPS 
register used as the real memory address of the exchange 
package* 



If you do not specify a value for this parameter* the 

active exchange package is used* 

processor 

Specifies the number of the processor to be used for 
maintenance register access* to obtain an exchange package 
address or to locate an active exchange package* 

address.mode 

Determines the interpretation of the address argument. 
Possible settings are J 

o PROCESS.VIRTUAL.ADDRESS <PVA) - causes interpretation as 

foil OH 5 J 

sssnnnnnnnnC 161 
with s being the segment number and n the offset* 
o SYSTB'LVIRTUAL.ADQRtSS (S¥A> - 

aaaann nnnnnn (16) 

a is the assigned segment identifier lasid) and n is the 
offset. 

o REAL_HEMORY_ADDRESS <RHA> - Adress specifies the 
starting real leiuory byte address to be displayed* 

If you do not specify a value for this parameter* process., 
vi rtual^addr ess is used* 

Example: ad/scb * SSYH80L ADDR£$S(nrtv$scb) 
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ad/msga - sob + 3a (16) 

ad/rosgl * Smemor y( scb + 38(16) 1 monitor! 
ad/disy $M£HORYJ>rRINGf«nsga msgl monitor) 
HR- unable to flush file 
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Fl.3.4 $f10QUL£ 

Purpose* Returns the module na«e corresponding to a given address by 
searching the debug table. The result is type string* 

Formats $HODUl£< address) 

Parameters* address 

Specifies the process virtual address to be used to search 
the debug table* An errar status will he returned if no 
module can be found that corresponds to the given address* 

Example* ad/disv $modul e< 3DlcOQ03el7e ( 16) ) 
BAM$SYS_BLK. VARIABLE J* EC .FA* 
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Fl.3.5 $NILJ>VA ($NP) 

Purpose! Returns a value of true or false based upon the given 
address* A nil pva is an Integer of the for mi 

rsssnnnnnnnn(I6) 

Where r * 0f(16)* sss ' 0fffC16) and the offset portion is 
negative (bit 2 **■ 31 is set)* The result is type boolean. 

Format: $NXL_PVA( address) 

Parameters* address 

Specifies the process virtual address to be tested. 

Exampi et ad/disv $NIL_PVA{$menory< 300000000(16) )) 
FALSE 

ad/disv SNIL.PVAOf f f f f f f f f f f f (16) ) 
TRUE 

ad/disv SNIL.PVAOffff 80000000(16) ) 
TRUE 
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Fl.3.6 SOFFSHT UQFF) 
Purpose? 



Returns the segment offset portion of a given address* The 
result is type integer. 



Format* 



$OFFSET<address) 



Parameters? address 

Specifies the address that is to be interpreted. 
This argument is required. 



Exampl e* 



ad/disv $QFFSET<301cOD03el7e { 16 M 
3E17EU6) 
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Fl.3.7 $PP_ME«GRY C$PH) 
Purposes 



Returns the contents of a vtord of pp memory. The result is 
type integer* 



Formats 



$PP_MEHGRYCpp_nu!»ber# addr ess) 



Parameters* pp_number 



Specifies the number of the oerpheral processor* Values of 
to 25 are allowed* If the specified pp Is not included 

in the dump# an error status is returned* 

This parameter is required. 

address 

Specifies the word in op. * en or. y to be returned* Values of 
to 4095 are allowed. 

This parameter is required* 



E x am P I e i 



ad/disv $PP_MEMQRr<6» 140(8 )1 
6(8) 
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Fl.3.8 $PRQCESS_R£GIST£R <$PR) 
Purpose i 



Returns the contents of a process register as defined by an 
exchange package* The exchange package can be on& active 
at the time of the dump or it can be . an exchange package in 
memory* The result is tyoe integer. 



Format J 



$PRaCES$_R£GI5TER(register_Mnd# regi ster_nun?ber* exchange* 
processor) 



Parameters* register.kind 



Specifies the kind of register. The following keywords are 
at toned* 

o p 

o a 

o x 

o moni tor.condi ti on_regi star (aicr) 

o user. condi t lon.r eg I ster' Cucr) 

o segment_tab le_address (stal 

o top_of_stack Ctos) 



This argument is required. 

regi ster_nurober 

Defines the a* x or top.of. stack register* It is ignored 
for other regi star _ki nds. Allowable values are through 
15 for a and x> 1 through 15 for top_of_stack« 

If you do not specify a value for this parameter* a vaiue 

of is used. 

exchange 
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Specifies the exchange package location* It may be given 
as an integer or as a keyword* An integer value is 
interpreted as the starting real memory address of an 
exchange package* 



The following are allowable keywords* 

o Active (a) - indicates that the contents of the CPU at 
the time of the 4ump mr e to be used* 

o Hon! tor (m) - indicates that the processor laintenance 

registers are to be accessed and the value in the ffPS 

register be used as the real memory address of the 
exchange package. 

o Job (j) - indicates that the processor maintenance 
registers are to be accessed and the value in the JPS 
register used as the real memory address of the exchange 
package* 



If you do not specify a value for this parameter* the 
active exchange package is used* 

processor 

Specifies the number of the processor to be used for 
maintenance register access* to obtain an exchange package 
address or to locate an active exchange package. 



Example* ad/disv SPROCESS.REGISTERt a 2) 

100FOOOOOC80(16) 
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F1.3*9 $R£AL_HEMORY_ADDR£SS ($RHA) 
Purposes 



Translates a process virtual address or a system virtual 
address Into a real memory address. It can also be used to 
test for a valid real memory address* The result is type 
integer. 



Formats 



$REAL_MENOR.Y_ADDRESS{ address.* exchange* processor* address, 
mode) 



Parameters s 



address 

Specifies the address to be converted, 

exchange 

Designates the exchange oackage to be used to define the 
virtual address* It may be specified as an integer or as a 
keyword* An integer value is interpreted as the starting 
real memory address of an exchange package* 

The following are allowable keywords! 

o Active (a) - indicates that the contents of the CPU at 
the tine of the dumo are to be used* 

o Monitor (m) - indicates that the processor maintenance 

registers are to be accessed and the value in the HPS 

register be used as the real memory address of the 
exchange package* 

o Job U> - indicates that the processor maintenance 

registers are to be accessed and the value in the JPS 

register be used as the real memory address of the 
exchange package* 



If you do not specify a value for this parameter* the 
active exchange package is used* 

processor 
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Specifies the number of the processor to be used for 

maintenance register access* to obtain an exchange package 

address or to locate an active exchange package. 

address_mode 



$r eal_memory_address <$rma) 

This argument determines the interpretation of the address 
parameter* Possible settings are* 

o PRQCESS_VIRTUAL_AD!)RSSS (pva) - causes interpretation as 
f ol J owsi 

sssnnnnnnnn (16) 
with s being the segment number and n the offset* 
o SYSTEft_VIRTUAL_ADDR5S$ <sva) - 

aaaannnnnnnnM.5 ) 

a is the assigned segment identifier (asid) and n is the 
offset* 

o R£AL_MEMORY_AQDRtSS Cruja) - Adress specifies a real 
memory address* An error status will be returned if the 
given address is not on the dump* Otherwise* the 
address argument is returned as the function result* 



If you do not soecify a value for this parameter* PROCESS. 
VIRTUAL.ADORESS is used* 



Example* ad/disv SRMA(100FD0000C83C16) ) 
588CB0U6) 
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Fl.3,10 $RIN6 
Purpose* 



Returns the ring portion of a given process virtual 
address* The result is type integer* 



Format? 



$RINS( address) 



Parameters? address 

Specifies the address that is to be interpreted 
This argument is required. 



Ex am pi a J 



ad/disv *RING< 30lc00Q3el7e(16J> 
3C16I 
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Fl.3.11 ISECTIQN <$S£C) 

Purpose? Returns the section name and offset into the section given 
a process virtual address. This function uses the debug 
table* The result Is tyoe string. 

Formats $3 FCTIONC address) 

Parameters! address 

Specifies the process virtual address to be used to search 
the debug table* An error status will be returned if no 
entry can be found that corresponds to the given address* 
This parameter is required* 

Example: ad/disv $SECTI0N(301c0003el7e(16) ) 
GEOIEXT + 9A£(16) 
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Fl.3.12 SSEGMENT USEG) 
Purpose* 



Returns the segment portion of a given process virtual 
address. The result is tyoe integer* 



F o r® a t * 



$Sfc£NENT(addressJ 



Parameters! address 

Specifies the address that is to be interpreted 
This argument is required. 



Exampi e» 



ad/disv $SEGH6NTC301c0003el7e< 16) I 
1CU6) 
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Fl*3*13 $SYM80L_ADDR€SS USA) 
Purpose! 



Converts a name into a process virtual address by accessing 
the debug table* It allocs you to find the address of a 
variable* procedure or module* The result is type integer* 



Formats 



$SYMBOL.ADDRESS< symbol .name) 



Parameters! syrabol_name 

Specifies the naaae of the variable* procedure or module* 
This argument is required* 



Exam pi ei 



ad/disv $5¥M8QL_49DRESS<iatv$scb) 
100000238(16) 
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FI.4 ayi£H.EI££SII4C£ 

Fl*4*l ANALYZE.DUHP COMMAND 

anal yze^dump lanad) 

dunp.fi I e^ df * file * Soptional 

restart^f i I e* rf s file - $!oca1 *«r estart.f i 1 e 

debug_table* dt 8 file or key runni ng.system* rs> none* n » runn i ng_syst en* 

title* t s string 1**25 ■- Soptional 

output* o t file « Soutnut 

status s var of status ■ Soptional 

Fl.4.2 SUBCOMMANDS 



• • 



change.def aui t (chad) 
exchange* e t integer 0«*$max. integer or key monitor* «ii# job* j* 

acti va* a ■ $opt i onal 
processor* p s integer 0«*3 « Soptional 

bytes* b s integer 0..33554432 * Soptional 

address.mode* am s key pracess.vi r tual _a1dr ess* pva* *« 

system.f J rtual.address# sva* r eal_memory_address* 

rffla a Sopt i onal 
words* m i integer ••' 4096 » Soptional 

status J var of status ■ Soptional 

change_processor_reg i ster <cnange_or ocessor_regi sters* chapr ) 

job_process_state* jps t integer 0* *S?nax_i nteger ■ Soptional 

monl tor..process_state* mps * ivteger 0*'»Snax.integer « Soptional 

page.si za_jnask* psm s integer 0*.127 s Soptional 

page_tabl e_address* pta : integer D* •Smax.i nteger « Soptional 

page_tabl e_l ength* ptl * integer 0**255 » Soptional 

processor* p s integer 0*«3 or key all* a * 

status J var of status » Soptional 



copy^memory (copm) 

address* a J integer « Srequtred 

f I I e* f J f I le « Srsnui red 

byte_count* be i integer 0*^Smax. integer * 100000(16) 

exchange* e J integer 3* **^ax_i nteger or key active* a* 

monitor* i» job* j « active 

processor* p t integer 0**3 * 
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Fi.4*2 SUBCOMMANDS 



addressee da* am 



status 



J key process_vi rtual_address* pva* *« 
systa?B_yi rtual .address* sva* •» 
raal_ue?!iory_addr ess* fia ■ •• 
pr ocess.y 1 r tu a 1 .address 

t var of status * (optional 



copy.pp. memory tcoppm) 
PP_number* pn J integer 0*»25 s (required 



file* f 

address* a 
word.count* wc 

status 



i file * $requi red 

s integer 0..4O95 « D 

: integer 0*.4D9 6 » 4096 

J var of status s (optional 



di spl ay_ca 1 1 
exchange* e 

processor* p 



Cdi sp i ay.cal I s* 

s integer 



count* c 
start* s 


t 
t 


dispi ay_opti on* 
title* t 
output* 
status 


do t 
i 
i 

t 



di sc) 

D« ; « (iBax_i nteger 

active* a » act! ve 
integer 0.*3 * 

integer 1»*IOO0O or key al) * alt 
integer 0«*10D0D or key exchange_package# 

* exchangejpackage 
list 1««2 of key full* f* brief* b* save* 
string 1*.31 * ' di so I ay.catl • 
file- Sou tout 
var of status * (optional 



or key monitor* mp job* j> 



ep 



s ■ brief 



d i sp I ay_exchange_package < di sep I 



exchange* e s 

processor* p t 

title* t » 

output* o J 

status t 



mr fr o M '\ O 3 i. » u 1 A *i f» .» 

integer 0««(max. integer or key monitor* m* job* j* . 

active* a - active 
integer 0..3 » 

string l.#31 * f di spl ay..exchange. package a 
file * (output 
var of status a (optional 



di sp I ay.mal ntenance.regi stars (d i spI ay^mai ntenance.r egister* dismrl 



element* e i 

processor* p * 

dispi ay_opti om do * 

title* t J 

output* o ? 



key processor* o* i nput_output_un i t* iou* memory* m» 

all * ail 
integer D«#3 * 
key full* f* brief* b « full 

string l»«3l = ' di so I ay.mai ntenance.regi sters * 
file * (output 
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Fl.4.2 SUBCOHHANOS 



address* a 
bytes* b 
exchange* e 




j 

t 

• 
• 


processor* p 

address... mode/ 


am 


t 
: 



status : yar of status * Soptional 



disp I ay.meaor y (dism) 

integer * Sraquired 

integer 3«;«33554432 * 8 

integer 0V«$<*ax_i stager or key active* a* •• 

monitor* m» job* j * active 
integer 0..3 - 

key pr ocass.y i rtua l.address* pva* *• 
systei.vl rtual .address* sva* •• 
real.menory. address* rma « *• 
pr oces s_v \r t u a I _a dd r e s s 
displ ay.opti on* do * list 1»*2 of Key numeric* n* ascii* a •• 

- (nuner i c* asci i) 
title* t i string 1..91 * « di so ! ay.memory * 

output* o i file * Soptional 

status « var of status » Soptlonal 

di sp J ay_pp_memory (dispm) 

PP. number* pn i integer 0..25 * Srequired 

address* a J integer Q..409S = 

words* w J integer 0..4096 ■ 4096 

displ ay_opt ion* do s list 1*«2 of key numeric* n» •• 

ascii* a » (numeric* ascii) 

radix* r : integer 8* .16 « 8 

dispi ay_r eiocat ion.regi star* drr * boolean « $optional 

title* t * string 1.. 31 * Soptional 

output* o * file * Soptlonal 

status : var of status « Soptional 

quit C qui ) 
status * var of status * Soptional 

Fl.4.3 FUNCTIONS 

$mai ntenance.regi ster * integer ($nr# 
register 2 integer »* 0ffC15) or key moni tor. processes tate* irps* 

job.pr ocess.state* jos * Srequired 
element * key processor* p* i nput_output_uni t* iou* memory* m 

» processor 
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Fl.4.3 FUNCTIONS 



processor s integer 0««3 * 



(memory s integer l$meni) 



address 
byte. count 
exchange 

processor 



t Integer - (required 

t Integer 1«*3 « 6 

i integer 0*«(max_l rtteger or key active* a* monitor* m* . . 

job* j »•■ act f ve 
s integer 0.»3 * 
address.aiode* am s key process.vi r tual .addr ess* pva* •• 

system.* i rtual .address* sva» reai.fBeiiiory. address* •• 

rma - process.? i rtual. address 



(mem cry. string J string ($«s) 



t integer 3 (required 

? integer 0.»osciiax.s tr i ng.s I ze * i 

i integer 0* ilmax.i nt ager or key active* a* monitor* m* •• 

job* j a active 
s integer 0..3 s 
address_niode» am : key process.vi r tual .addr ess* pva* •• 

system. vi r tual .address* sva* real .memory, address* •« 

rn?a = process.v i rtual .address 



address 

byte.count 

exchange 

processor 



(module* string 
address: integer * (required 



(nil. ova* boolean ((np) 
address* integer * (required 



(off set J integer {(off) 
address? integer * (required 



;pp. memoryJ integer ((pis) 

pp^ number * integer •• Z5 » (required 

address * integer . . 4095 = (required 
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Fl.4.3 FUNCTIONS 

$pro cesser eg i ster* integer <$pr) 
regi ster_type : key p» a* x» sioni tor^condi t i on_regi ster* mcr 

user_condi ti on_r eg! ster* ucr 

segmentjtab f a.addr ess# sta* top_.of.st ack* tos 
* Srequired 
register_nymber ? integer 0«*OMi&) *■ 
exchange * integer 0*«$:iiax_ integer' or key active* a* monitor* as* •* 

job* j * active 
processor J integer G*»3 * 



$real_mefBor y_address s integer i%rma) 
address J integer * $required 

exchange : integer C. •Smax.'i nteger or key active* a* monitor* m* •« 

job* j - active 
processor s integer 0#«3 « 1 

address,juode J key process.vi rtual _addr ess* ova* •• 

system_virtija!_address* sva* r ea i^mesnory^addr ess* • 
ra?a « pr o cess _vi rtual_addr ess 

Iring: integer 
address * integer ■ Srequired 

Ssections string (isec) 
address J integer ■ $required 

$seg?aent* integer ($seg) 
address ? integer = $required 

Ssymbo i_addresss integer <$sa) 
symbol _na?ne i name = ^required 
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